Siirry sisältöön
Luonnos

vite-plugin-xu

Koontiaikainen Vite-liitännäinen, joka kääntää .xu-yhden tiedoston komponentin oikeaksi ES-moduuliksi.

@xuda/vite-plugin-xu kääntää .xu-yhden tiedoston komponentit ES-moduuleiksi koonnin aikana ja lataa ne dev-tilassa uudelleen koko komponentin uudelleenlatauksen tasolla.

Työtilapaketti nykyisin, ei npm-asennus

@xuda/vite-plugin-xu ja sen käyttämä @xuda/compiler-paketti sisältävät molemmat "private": true omassa package.json-tiedostossaan. Toisin kuin xuda-cli, create-xuda-cli ja @xuda/core, kumpaakaan ei ole vielä julkaistu npm:ään. Tämän repon ainoa toimiva käyttäjä, examples/hello, käyttää sitä file:-riippuvuutena: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".

Käyttöönotto

js
// vite.config.js
import { defineConfig } from 'vite';
import xu from '@xuda/vite-plugin-xu';

export default defineConfig({ plugins: [xu()] });
js
// src/main.js
import { createApp } from '@xuda/core';
import App from './App.xu';

createApp(App).mount('#app');

examples/hello on täysi toimiva projekti, joka on rakennettu näin: laskuri, ehdollinen liitos ja avainnettu lista, joita ohjataan kokonaan tavallisilla funktioilla ja tavallisella muutoksella reactive()-storen yli, ilman signaaleja, .value-arvoa tai datalähdekerrosta näkyvissä itse komponentissa.

Mitä liitännäinen on mekaanisesti

Yksi transform-koukku. Viten oletus-load on jo lukenut tiedoston, joten koukku saa .xu-lähteen tekstinä, kutsuu @xuda/compiler-pakettia ja palauttaa tuotetun moduulin. Mukautettua resolveria tai virtuaalimoduulia ei ole: .xu pysyy oikeana tiedostona oikealla polulla, mikä pitää pinojäljet ja HMR-graafin rehellisinä.

enforce: 'pre' on tärkeä: ilman sitä vite:esbuild voi ehtiä tiedostoon ensin ja epäonnistua <template>-tagiin, mikä näyttää tiedoston rikkinäisyydeltä eikä putken väärältä järjestykseltä. Vite lisää myös ?import-osan ei-JS-tuonteihin (ja ?t=… HMR-uudelleenpyynnössä), joten liitännäinen poistaa sen ennen include-testiä, muuten tiedostoa ei hiljaa käännetä ja selain ilmoittaa syntaksivirheestä tiedostossa, jota kirjoittaja ei ole koskaan kirjoittanut.

HMR

Toteutettu taso on koko komponentin uudelleenlataus: muokkauksen yhteydessä moduuli suoritetaan uudelleen, kaikki kyseisen komponentin liitetyt instanssit puretaan ja liitetään uudelleen uudesta moduulista, ja komponentin tila nollautuu. reactive({ count: 0 }) kohdassa <script> palaa arvoon 0. Tilan säilyttämistä ei tarkoituksella yritetä, koska <script>-lohkon muokkauksen jälkeen ei ole luotettavaa tapaa tietää, mikä puoli vanhasta reaktiivisesta oliosta tarkoittaa yhä samaa.

Serve-tilassa liitännäinen lisää import.meta.hot.accept-alatunnisteen. createApp paketissa @xuda/core asentaa __XUDA_HMR__-arvon, kun sovellus liitetään ensimmäisen kerran, joten liitännäinen ei koskaan lisää tuontia käyttäjän koodiin. Jos mikään liitetty sovellus ei vaadi päivitettyä komponenttia (kukaan ei näyttänyt sitä tai sivu ei ole käynnistynyt), päivitys palaa koko sivun uudelleenlataukseen sen sijaan, että mitään ei tapahtuisi hiljaa. Tuotantokoonti ei saa HMR-alatunnistetta lainkaan.

Asetukset

Katso .xu-kieli lohkopohjaisesta murteesta, jonka xuda-cli kääntää, ja siellä oleva huomautus siitä, miten tämän kääntäjän murre eroaa siitä.