Naar de inhoud springen
Geverifieerd

HTML schrijven in Slim

Schrijf gewone HTML, voeg Xuda-directives toe en laat Slim er een programmaboom van maken.

HTML schrijven is de directste manier om Slim te leren. In plaats van een compiler schrijf je gewone HTML en voeg je Xuda-directives toe die velden binden, uitvoer berekenen, zichtbaarheid schakelen, acties uitvoeren of over data itereren.

Denkmodel

  • gewone HTML voor structuur
  • datasource-velden voor state
  • @field_name-expressies om te lezen
  • Xuda-directives om gedrag aan te sluiten
html
<div xu-store="{'headline':'Hello Xuda'}">
  <input xu-bind="headline" />
  <h1 xu-exp:xu-content="@headline"></h1>
</div>

Een volledige pagina

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>

Hoe <template> een programma wordt

Bevat de pagina <template>-tags, dan leest Slim ze allemaal, gebruikt het id-attribuut van de template als programma-id (of template_<index> als er geen id is), parset de markup tot progUi en slaat het resultaat op onder _session.project_data.programs. Als er geen prog_id is meegegeven, wordt de eerste template op de pagina het startprogramma.

Templates zijn optioneel. Geef je al project_data mee, dan breiden templates die data uit in plaats van haar te vervangen.

Veelgebruikte HTML-directives

De volledige directive-referentie, inclusief expressies en events, staat bij Runtime-directives.

Parsing van attribuutwaarden

Templateattributen die eruitzien als JSON, een array ([...]), een object ({...}) of een gequote JSON-string, worden geparsed met JSON.parse. Een geldige wordt een echt object of een echte array in progUi; een ongeldige blijft een gewone string. xu-store is de uitzondering: de handler parset met JSON5, dus syntaxis in JSON5-stijl (ongequote sleutels, enkele aanhalingstekens) werkt daar nog.

Wanneer HTML schrijven beter past

Gebruik het voor docs-pagina's, microsites, landingspagina's van producten, insluitbare widgets en met de hand geschreven prototypes. Stap over naar de CLI zodra de app uitgroeit tot meerdere features met routes, persistentielogica een duidelijkere plek nodig heeft, of meerdere eenheidstypen zoals get_data, set_data en batch buiten de pagina moeten leven.