Přeskočit na obsah
Ověřeno

Xuda Slim

Odlehčený vstupní bod do runtime Xudy pro prohlížeč, bez nutnosti načítat projekt.

Xuda Slim je odlehčený povrch pro psaní a vkládání do runtime Xudy. Hodí se, když chcete reaktivní zdroj dat Xudy, direktivy, události a strukturální tagy, aniž byste začínali plným tvarem projektu Xuda CLI.

Slim je stále Xuda, ne jiný runtime. Výrazy pořád čtou pole pomocí @field_name, runtime pořád pracuje s programovými dokumenty Xudy a strukturální tagy jako xu-single-view a xu-panel pořád mají význam. <template> je podporován, ale není povinný.

K čemu Slim slouží

  • ručně psané stránky HTML s reaktivitou Xudy
  • ukázky runtime a dokumentace
  • vložitelné widgety nebo mikrowebu
  • generované stromy runtime project_data
  • postupné přijímání Xudy bez nutnosti zavádět nejdřív plný zdrojový kompilátor

Tři režimy psaní

Tyto režimy lze míchat: pokud Slim dostane project_data a stránka má také tagy <template>, šablony se naparsují a přidají do project_data.programs vedle něj.

Načtení runtime

Podporovaný způsob, jak získat balíček, je veřejný balíček npm @xuda.io/xuda-runtime-slim-es. Pokud máte nasazenou aplikaci Xuda, platforma také servíruje balíček runtime z vaší vlastní domény aplikace na /cdn, s nezminifikovaným sestavením na /cdn/debug.

html
<script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
V produkci nenačítejte z vývojového hostitele

Tag script výše míří na vývojového hostitele, což se hodí k vyzkoušení Slim lokálně. Nasazená stránka by měla načítat @xuda.io/xuda-runtime-slim-es nebo servírovat balíček z vaší vlastní domény aplikace na /cdn.

Konstruktor

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

Argumenty se přiřazují podle typu, ne podle pozice: element, objekt voleb a callback lze předat v libovolném pořadí.

  • element: element DOM, do kterého se připojuje. Ve Slim volitelný: když ho vynecháte, runtime se vrátí k document.body a zapíše varování místo selhání.
  • options: volby relace a runtime, popsané níže.
  • callback: zavolá se jako callback('xuda_ready', SESSION_ID, SESSION_OBJ), jakmile je aplikace připravena.

Pro dokončení připojení je nejspolehlivějším háčkem událost on_mounted na document.body:

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

Běžné volby

Každá níže uvedená volba se určuje stejným šestikrokovým řetězcem: nejdřív parametr dotazu v URL, pak atribut na kořenovém elementu, pak options.params[key], pak options[key], pak cookie a nakonec localStorage. Proto lze stránku Slim překonfigurovat z řetězce dotazu bez změny kódu.

Jak poznat, že Slim funguje

  • balíček se načetl
  • váš prog_id vykreslí něco viditelného
  • spustí se událost on_mounted
  • UI řízené poli se začne chovat reaktivně

Pokud nastanou všechny čtyři, je stránka v pořádku. Pokud se nic nevykreslí, zkontrolujte v tomto pořadí: balíček se skutečně načetl, prog_id odpovídá skutečnému id šablony nebo klíči programu, program existuje v project_data.programs a cíl připojení je skutečný element (nebo je záměrně ponechán na záložní body).