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.
@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
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ä.