Ugrás a tartalomhoz
Piszkozat

vite-plugin-xu

Build idejű Vite bővítmény, amely a .xu egyfájlos komponenst valódi ES-modullá fordítja.

Az @xuda/vite-plugin-xu a .xu egyfájlos komponenseket ES-modullá fordítja build időben, és fejlesztés közben teljes komponensújratöltés szintjén újratölti őket.

Ma munkaterület-csomag, nem npm-telepítés

Az @xuda/vite-plugin-xu és az @xuda/compiler csomag, amelytől függ, egyaránt "private": true értéket hordoz a package.json fájljában. Az xuda-cli-vel, a create-xuda-cli-vel és az @xuda/core-ral ellentétben egyik sincs még közzétéve az npm-en. Az egyetlen működő felhasználó ebben a tárolóban, az examples/hello, file: függőségként éri el: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".

Beállítás

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');

Az examples/hello egy így épített, teljes működő projekt: számláló, feltételes csatolás és kulcsolt lista, amelyet teljes egészében egyszerű függvények és egyszerű módosítás hajt egy reactive() tárolón, anélkül hogy jelek, .value vagy adatforrás-réteg látszana magában a komponensben.

Mi a bővítmény, mechanikusan

Egyetlen transform horog. A Vite alapértelmezett load lépése már beolvasta a fájlt, így a horog a .xu forrást szövegként kapja, meghívja az @xuda/compiler fordítót, és visszaadja a kibocsátott modult. Nincs egyéni feloldó és nincs virtuális modul: a .xu valódi fájl marad valódi úttal, ami megőrzi a veremkövetések és a HMR-gráf hitelességét.

Az enforce: 'pre' számít: nélküle a vite:esbuild előbb érheti el a fájlt, és elbukhat a <template> elemen, ami úgy látszik, mintha a fájl lenne elromolva, nem pedig a folyamat sorrendje rossz. A Vite a nem JS importokhoz ?import utótagot is fűz (HMR újrakérésnél ?t=… utótagot), ezért a bővítmény ezt eltávolítja az include teszt előtt, különben a fájl csendben nem fordul le, és a böngésző szintaktikai hibát jelez egy olyan fájlban, amelyet a szerző sosem írt.

HMR

A megvalósított szint a teljes komponensújratöltés: szerkesztéskor a modul újra lefut, a komponens minden csatolt példánya lecsatolódik és az új modulból újracsatolódik, és a komponens állapota alaphelyzetbe áll. Egy <script> részben lévő reactive({ count: 0 }) visszaáll 0 értékre. Az állapot megőrzését szándékosan nem kísérli meg, mert egy <script> szerkesztése után nincs megbízható módja annak megállapítására, hogy a régi reaktív objektum melyik fele jelent még ugyanazt.

Kiszolgáló módban a bővítmény egy import.meta.hot.accept láblécet fűz hozzá. A __XUDA_HMR__ változót az @xuda/core createApp függvénye telepíti, amikor egy alkalmazás először csatolódik, így a bővítmény soha nem szúr be importot a felhasználói kódba. Ha egyetlen csatolt alkalmazás sem tart igényt a frissített komponensre (senki sem jelenítette meg, vagy az oldal még nem indult el), a frissítés teljes oldalújratöltésre vált, ahelyett hogy csendben nem csinálna semmit. Az éles build egyáltalán nem kap HMR láblécet.

Beállítások

Az xuda-cli által fordított blokkalapú dialektusról a A .xu nyelv oldalon olvashat, ott a kiemelésben azt is, miben tér el ettől ennek a fordítónak a dialektusa.