Přeskočit na obsah
Ověřeno

Psaní v HTML ve Slim

Pište běžné HTML, přidávejte direktivy Xudy a nechte Slim z něj vytvořit strom programu.

Psaní v HTML je nejpřímější způsob, jak se Slim naučit. Místo kompilátoru píšete obyčejné HTML a přidáváte direktivy Xudy, které vážou pole, počítají výstup, přepínají viditelnost, spouštějí akce nebo iterují nad daty.

Mentální model

  • běžné HTML pro strukturu
  • pole zdroje dat pro stav
  • výrazy @field_name pro čtení
  • direktivy Xudy pro zapojení chování
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>

Jak se <template> stane programem

Když stránka obsahuje tagy <template>, Slim přečte každý z nich, použije atribut id šablony jako id programu (nebo template_<index>, pokud id chybí), naparsuje markup do progUi a výsledek uloží pod _session.project_data.programs. Pokud není zadáno prog_id, startovním programem se stane první šablona na stránce.

Šablony jsou volitelné. Pokud už předáváte project_data, šablony tato data rozšiřují, ne nahrazují.

Běžné direktivy HTML

Úplná reference direktiv, včetně výrazů a událostí, je na stránce Direktivy runtime.

Parsování hodnot atributů

Atributy šablony, které vypadají jako JSON, pole ([...]), objekt ({...}) nebo řetězec JSON v uvozovkách, se parsují pomocí JSON.parse. Platný se v progUi stane skutečným objektem nebo polem; neplatný zůstane obyčejným řetězcem. Výjimkou je xu-store: jeho obslužná rutina parsuje pomocí JSON5, takže tam syntaxe ve stylu JSON5 (klíče bez uvozovek, jednoduché uvozovky) stále funguje.

Kdy se psaní v HTML hodí nejlépe

Použijte ho pro stránky dokumentace, mikroweby, produktové vstupní stránky, vložené widgety a ručně psané prototypy. Přejděte na CLI, jakmile aplikace vyroste do více směrovaných funkcí, logika ukládání potřebuje jasnější domov nebo by několik typů jednotek, například get_data, set_data a batch, mělo žít mimo stránku.