Preskočiť na obsah
Overené

Xuda Slim

Odľahčený vstupný bod do runtime Xuda pre prehliadač, bez potreby loadera projektu.

Xuda Slim je odľahčený povrch na tvorbu a vkladanie pre runtime Xuda. Hodí sa, keď chcete reaktívny zdroj dát, direktívy, udalosti a štrukturálne tagy Xuda bez toho, aby ste začínali od celého tvaru projektu Xuda CLI.

Slim je stále Xuda, nie iný runtime. Výrazy stále čítajú polia pomocou @field_name, runtime stále pracuje s dokumentmi programov Xuda a štrukturálne tagy ako xu-single-view a xu-panel stále záležia. <template> je podporovaný, ale nie je povinný.

Na čo je Slim určený

  • ručne písané stránky HTML s reaktivitou Xuda
  • ukážky runtime a dokumentácia
  • vložiteľné widgety alebo mikrostránky
  • vygenerované stromy project_data pre runtime
  • postupné zavádzanie Xuda bez toho, aby ste najprv museli zaviesť plný zdrojový kompilátor

Tri režimy tvorby

Tieto režimy sa dajú miešať: ak Slim dostane project_data a stránka má aj tagy <template>, šablóny sa parsujú a pridajú sa do project_data.programs vedľa neho.

Načítanie runtime

Podporovaný spôsob, ako získať balík, je verejný balík npm @xuda.io/xuda-runtime-slim-es. Ak máte nasadenú aplikáciu Xuda, platforma poskytuje balík runtime aj z vašej vlastnej domény aplikácie na /cdn, s neminifikovanou verziou na /cdn/debug.

html
<script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
V produkcii nenačítavajte z vývojového hostiteľa

Tag script vyššie mieri na vývojového hostiteľa, užitočného na vyskúšanie Slim lokálne. Nasadená stránka by mala načítať @xuda.io/xuda-runtime-slim-es alebo poskytovať balík z vlastnej domény aplikácie na /cdn.

Konštruktor

js
new xuda(element?, options?, callback?)
new xuda.xuda(element?, options?, callback?)

Argumenty sa priraďujú podľa typu, nie podľa polohy: element, objekt možností a callback možno odovzdať v ľubovoľnom poradí.

  • element: element DOM, do ktorého sa pripája. V Slim voliteľný: vynechajte ho a runtime sa vráti k document.body a zaloguje varovanie namiesto zlyhania.
  • options: možnosti relácie a runtime, rozobraté nižšie.
  • callback: volaný ako callback('xuda_ready', SESSION_ID, SESSION_OBJ), keď je aplikácia pripravená.

Na dokončenie pripojenia je najspoľahlivejším hookom udalosť on_mounted na document.body:

js
document.body.addEventListener('on_mounted', () => {
  console.log('Slim page mounted');
}, { once: true });

Bežné možnosti

Každá možnosť nižšie sa určuje rovnakým šesťkrokovým reťazcom: najprv parameter dotazu v URL, potom atribút na koreňovom elemente, potom options.params[key], potom options[key], potom cookie a nakoniec localStorage. Preto sa dá stránka Slim prekonfigurovať z reťazca dotazu bez zmeny kódu.

Ako zistiť, že Slim funguje

  • balík sa načítal
  • váš prog_id vykreslí niečo viditeľné
  • spustí sa udalosť on_mounted
  • UI riadené poľami sa začne správať reaktívne

Ak nastanú všetky štyri, stránka je v poriadku. Ak sa nič nevykreslí, skontrolujte v poradí: že sa balík skutočne načítal, že prog_id zodpovedá skutočnému id šablóny alebo kľúču programu, že program existuje v project_data.programs a že cieľ pripojenia je skutočný element (alebo je zámerne ponechaný na náhradu cez body).