Siirry sisältöön
Tarkistettu

@xuda/core

Riippuvuuksista vapaa reaktiivinen moottori, jonka päälle alusta, kääntäjä ja esimerkkisovellukset liitetään.

@xuda/core on Xudan reaktiivinen moottori (signaalit, ajastin, avainnettu listaerotus, reaktiivinen renderöijä, reititin) riippuvuuksista vapaana ESM-pakettina. Se ei lue eikä kirjoita globaaleja muuttujia tuotaessa: ei func-, SESSION_OBJ-, window- eikä document-arvoa.

Ainoa julkinen paketti tässä dokumentaation osassa

@xuda/core:n package.json sisältää "private": false. Se on ainoa paketti tämän osion kolmesta (yhdessä @xuda/compiler- ja @xuda/vite-plugin-xu-pakettien kanssa, jotka ovat molemmat private: true), joka on rakennettu käytettäväksi riippuvuutena tämän repon ulkopuolella.

Se ei myöskään ole eri moottori kuin se, jonka alusta jo toimittaa: paketin oma build:globals-skripti (esbuild src/globals.js --bundle ... --outfile ../../runtime/js/xuda_core.globals.js) rakentaa tiedoston runtime/js/xuda_core.globals.js, alustan oman toimitetun reaktiivisen renderöijän paketin.

Reaktiivinen pinta

js
import { ref, reactive, computed, effect, watch, effectScope } from '@xuda/core';

Kaiken alla on yksi riippuvuusgraafi, yksi omistajapuu, yksi eräpuskuri ja yksi ajastin: effect():n sisällä luettu ref seuraa ja ajaa sen uudelleen, samoin kuin watch():n sisällä luettu signaali. computed hyväksyy tässä getterin tai { get, set }-parin kirjoitettavaa computedia varten.

js
const state = reactive({ count: 0 });
state.count++;             // no .get(), no .set()

const n = ref(0);
n.value++;

effectScope() vastaa kysymykseen "kuka hävittää tämän": nimetty omistaja, jota voi kuljettaa, sisäkkäistää ja pysäyttää yhdellä kutsulla, sen sijaan että kokoaisit itse kasan hävittäjiä.

js
const scope = effectScope();
scope.run(() => {
  effect(() => { /* ... */ });
  watch(source, callback);
  onScopeDispose(() => io.disconnect());
});
scope.stop();

createApp():n kautta instantioitu komponentti omistaa jo tällaisen: sen <script> ajetaan komponentin omassa irrotetussa scopessa, joten siellä kirjoitettu efekti hävitetään automaattisesti, kun komponentti puretaan.

Matalan tason primitiivi

signal(initial) (.get(), .set(), .peek(), .notify(), .subscribe()) ja signalComputed ovat moottorin omat solut ref:n ja computed:n alla. Ne on viety ja täysin tuettuja, ei poistettuja, koska renderöijä ja vanha silta on rakennettu niiden varaan, ja koska signal.notify(), joka ajaa tilaajat uudelleen ilman arvon muutosta, ei ole vastinetta ref:ssä. Sovelluskoodin kannattaa käyttää ref:iä ja computed:ia; nämä kaksi nimeä on dokumentoitu alemmaksi kerrokseksi, ei poistettaviksi suoritusaikana (varoitus signal():sta laukeaisi jokaisella rivin scopella ja paneelin parametrilla, tuhansia kertoja näkymää kohden, koodille joka tekee täsmälleen oikein sillä kerroksella).

Sovelluksen sisäänkäynti

js
import { createApp } from '@xuda/core';
import App from './App.xu';

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

App on käännetty .xu-moduuli, jonka tuottaa @xuda/compiler tai vite-plugin-xu-koontivaihe. createApp rakentaa seitsemän injektoitua riippuvuutta, joita renderöijä tarvitsee, moduulin setup():n palauttaman thunk-taulun päälle, luo renderöijän ja liittää komponenttipuun. Se ei ole toinen renderöijä: käännetty polku ja tulkittu alustapolku jakavat render.js:n.

examples/hello on tämän konkreettinen, testattu versio: createApp(App).mount('#app') käännetyn App.xu:n päällä, jossa on laskuri, ehto ja avainnettu lista.

Renderöijä, riippuvuusinjektoitu

js
import { create_renderer } from '@xuda/core';
import { reactive } from '@xuda/core/reactivity';

create_renderer(deps) on DOM-agnostinen. Kaikki ympäristöön liittyvä tulee yhden deps-olion kautta, ja pienin rehellinen isäntä tarvitsee tarkalleen seitsemän: document (createElement / createTextNode / createComment), evaluate (seurattu, synkroninen lausekkeen arvioija), cast_bool (tosiarvoisuus xu-render / xu-if varten), resolve_rows (seurattu rivitaulukon ratkaisija xu-for:lle), row_key (vakaa rivin identiteetti), write_field (xu-bind-kirjoitukset) ja dispatch_event (xu-on:*-käsittelijät). packages/core/demo rakentaa täsmälleen tämän tavallisen reactive({...})-olion päälle, ilman SESSION_OBJ:ia, datalähdekerrosta tai vanhaa siltaa alla.

Kaksi hiljaista DOM-sopimuksen ansaa, jos kirjoitat oman adapterin

deps.document-solmu, jolla ei ole nodeType:a, luetaan jQuery-oliona oikean DOM-solmun sijaan, mikä voi sisäkkäistää jokaisen rivin edeltäjänsä sisään ilman heitettyä virhettä. Solmu, jolla ei ole remove()-metodia, muuttaa pudotetun rivin hiljaa hylätyksi promiseksi: lista lakkaa päivittymästä eikä mitään kirjata. Demon create_adapter suojaa molemmat heittämällä virheen solmun luontihetkellä; anna { guard: false } poistaaksesi suojan, kun ymmärrät, miksi se on olemassa.

Diagnostiikka ja whenElement

onDiagnostic, getDiagnostics, diagnosticCount ja resetDiagnostics muuttavat moottorin hiljaiset luovutukset yhdeksi havaittavaksi kanavaksi hajanaisten console.error-kutsujen sijaan, jolloin isäntäadapteri tai testi voi tilata ne koodista. whenElement ajaa takaisinkutsun, kun solmu on olemassa: se kysyy kerran, kysyy sitten uudelleen ajastimen commit-vaiheessa (täsmälleen kun DOM asettuu, ennen maalausta), ja odotus, joka on yhä täyttämättä kahdenkymmenen asettuneen renderöinnin jälkeen, ilmoittaa itsensä nimellä sen sijaan, että luovuttaisi hiljaa.

Reititin

createRouter, createWebHistory, createWebHashHistory, createMemoryHistory, useRouter ja useRoute tulevat samasta paketista. Nykyinen reitti on @xuda/core:n oma reactive, ja historia tulee alustalta, joten sen käyttö ei lisää omaa riippuvuutta.

Paketin viennit

Ilmoitettu moottorin vähimmäisversio on Node 18 tai uudempi.