Zum Inhalt springen
Geprüft

HTML-Authoring in Slim

Schreibe normales HTML, füge Xuda-Direktiven hinzu und lass Slim daraus einen Programmbaum machen.

HTML-Authoring ist der direkteste Weg, Slim zu lernen. Statt eines Compilers schreibst du gewöhnliches HTML und fügst Xuda-Direktiven hinzu, die Felder binden, Ausgaben berechnen, Sichtbarkeit umschalten, Aktionen ausführen oder über Daten iterieren.

Mentales Modell

  • normales HTML für die Struktur
  • Datasource-Felder für den Zustand
  • @field_name-Ausdrücke zum Lesen
  • Xuda-Direktiven, um Verhalten zu verdrahten
html
<div xu-store="{'headline':'Hello Xuda'}">
  <input xu-bind="headline" />
  <h1 xu-exp:xu-content="@headline"></h1>
</div>

Eine vollständige Seite

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>

Wie <template> zu einem Programm wird

Enthält die Seite <template>-Tags, liest Slim jedes davon, verwendet das Attribut id des Templates als Programm-ID (oder template_<index>, wenn es keine ID gibt), parst das Markup zu progUi und speichert das Ergebnis unter _session.project_data.programs. Wird kein prog_id übergeben, wird das erste Template auf der Seite zum Startprogramm.

Templates sind optional. Übergibst du bereits project_data, erweitern Templates diese Daten, statt sie zu ersetzen.

Häufige HTML-Direktiven

Die vollständige Direktiven-Referenz, einschließlich Ausdrücken und Events, steht unter Laufzeit-Direktiven.

Parsing von Attributwerten

Template-Attribute, die wie JSON aussehen, ein Array ([...]), ein Objekt ({...}) oder ein JSON-String in Anführungszeichen, werden mit JSON.parse geparst. Ein gültiges wird in progUi zu einem echten Objekt oder Array; ein ungültiges bleibt ein einfacher String. xu-store ist die Ausnahme: Sein Handler parst mit JSON5, JSON5-Syntax (Schlüssel ohne Anführungszeichen, einfache Anführungszeichen) funktioniert dort also weiterhin.

Wann HTML-Authoring besser passt

Verwende es für Doku-Seiten, Microsites, Produkt-Landingpages, eingebettete Widgets und von Hand geschriebene Prototypen. Wechsle zur CLI, sobald die App zu mehreren gerouteten Features wächst, die Persistenzlogik ein klareres Zuhause braucht oder mehrere Einheitenarten wie get_data, set_data und batch außerhalb der Seite leben sollen.