Preskočiť na obsah
Overené

Tvorba v HTML v Slim

Píšte bežné HTML, pridávajte direktívy Xuda a nechajte Slim, aby z neho vytvoril strom programu.

Tvorba v HTML je najpriamejší spôsob, ako sa naučiť Slim. Namiesto kompilátora píšete obyčajné HTML a pridávate direktívy Xuda, ktoré viažu polia, počítajú výstup, prepínajú viditeľnosť, spúšťajú akcie alebo prechádzajú dáta.

Mentálny model

  • bežné HTML pre štruktúru
  • polia zdroja dát pre stav
  • výrazy @field_name pre čítanie
  • direktívy Xuda na prepojenie správania
html
<div xu-store="{'headline':'Hello Xuda'}">
  <input xu-bind="headline" />
  <h1 xu-exp:xu-content="@headline"></h1>
</div>

Celá stránka

html
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
  <script>
    document.addEventListener('DOMContentLoaded', () => {
      document.body.addEventListener('on_mounted', () => {
        console.log('HTML Slim page mounted');
      }, { once: true });

      const Xuda = globalThis.xuda?.xuda || globalThis.xuda;
      new Xuda(document.getElementById('app'), { domain: 'xuda.ai', prog_id: 'demo' });
    }, { once: true });
  </script>
</head>
<body>
  <div id="app"></div>

  <template id="demo">
    <div class="p-6" xu-store="{'title':'Hello from Slim HTML'}">
      <h1 xu-exp:xu-content="@title"></h1>
    </div>
  </template>
</body>
</html>

Ako sa <template> stane programom

Keď stránka obsahuje tagy <template>, Slim prečíta každý z nich, použije atribút id šablóny ako id programu (alebo template_<index>, ak id chýba), parsuje značkovanie do progUi a výsledok uloží pod _session.project_data.programs. Ak nie je zadané prog_id, štartovacím programom sa stane prvá šablóna na stránke.

Šablóny sú voliteľné. Ak už odovzdávate project_data, šablóny tieto dáta rozširujú, nenahrádzajú ich.

Bežné direktívy HTML

Úplná referencia direktív vrátane výrazov a udalostí je v Direktívy runtime.

Parsovanie hodnôt atribútov

Atribúty šablóny, ktoré vyzerajú ako JSON, pole ([...]), objekt ({...}) alebo JSON reťazec v úvodzovkách, sa parsujú pomocou JSON.parse. Platný sa v progUi stane skutočným objektom alebo poľom; neplatný zostane obyčajným reťazcom. Výnimkou je xu-store: jeho handler parsuje pomocou JSON5, takže syntax v štýle JSON5 (kľúče bez úvodzoviek, jednoduché úvodzovky) tam stále funguje.

Kedy je tvorba v HTML vhodnejšia

Použite ju pre stránky dokumentácie, mikrostránky, vstupné stránky produktov, vložiteľné widgety a ručne písané prototypy. Na CLI prejdite, keď aplikácia vyrastie do viacerých funkcií so smerovaním, logika ukladania potrebuje jasnejšie miesto alebo by niekoľko typov jednotiek, ako get_data, set_data a batch, malo žiť mimo stránky.