Zum Inhalt springen
Geprüft

Xuda Slim

Der leichtgewichtige Browser-Einstieg in die Xuda-Laufzeit, ganz ohne Projekt-Loader.

Xuda Slim ist die leichtgewichtige Authoring- und Einbettungsfläche für die Xuda-Laufzeit. Sie ist nützlich, wenn du die reaktive Datasource, die Direktiven, Events und Struktur-Tags von Xuda willst, ohne mit der vollen Projektform der Xuda CLI zu beginnen.

Slim ist weiterhin Xuda, keine andere Laufzeit. Ausdrücke lesen Felder weiterhin mit @field_name, die Laufzeit arbeitet weiterhin mit Xuda-Programmdokumenten, und Struktur-Tags wie xu-single-view und xu-panel zählen weiterhin. <template> wird unterstützt, ist aber nicht erforderlich.

Wofür Slim gedacht ist

  • von Hand geschriebene HTML-Seiten mit Xuda-Reaktivität
  • Laufzeit-Demos und Dokumentation
  • einbettbare Widgets oder Microsites
  • generierte project_data-Laufzeitbäume
  • schrittweise Einführung von Xuda, ohne zuerst einen vollen Quell-Compiler einzuführen

Die drei Authoring-Modi

Diese Modi lassen sich mischen: Erhält Slim project_data und hat die Seite zusätzlich <template>-Tags, werden die Templates geparst und neben ihm zu project_data.programs hinzugefügt.

Die Laufzeit laden

Der unterstützte Weg, das Bundle zu bekommen, ist das öffentliche npm-Paket @xuda.io/xuda-runtime-slim-es. Hast du eine bereitgestellte Xuda-App, liefert die Plattform das Laufzeit-Bundle außerdem von deiner eigenen App-Domain unter /cdn aus, mit einem unminifizierten Build unter /cdn/debug.

html
<script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
Lade nicht von einem Dev-Host in Produktion

Das obige Script-Tag zeigt auf einen Entwicklungs-Host, nützlich, um Slim lokal auszuprobieren. Eine bereitgestellte Seite sollte @xuda.io/xuda-runtime-slim-es laden oder das Bundle von deiner eigenen App-Domain unter /cdn ausliefern.

Der Konstruktor

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

Argumente werden nach Typ zugeordnet, nicht nach Position: Ein Element, ein Options-Objekt und ein Callback können in beliebiger Reihenfolge übergeben werden.

  • element: das DOM-Element, in das eingehängt wird. In Slim optional: Lässt du es weg, greift die Laufzeit auf document.body zurück und protokolliert eine Warnung, statt zu scheitern.
  • options: Sitzungs- und Laufzeitoptionen, unten behandelt.
  • callback: wird als callback('xuda_ready', SESSION_ID, SESSION_OBJ) aufgerufen, sobald die App bereit ist.

Für das Ende des Einhängens ist der verlässlichste Hook das Event on_mounted auf document.body:

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

Häufige Optionen

Jede Option unten wird über dieselbe sechsstufige Kette aufgelöst: zuerst ein URL-Query-Parameter, dann ein Attribut am Wurzelelement, dann options.params[key], dann options[key], dann ein Cookie, dann localStorage. Deshalb lässt sich eine Slim-Seite ohne Codeänderung über einen Query-String neu konfigurieren.

Woran du erkennst, dass Slim funktioniert

  • das Bundle wurde geladen
  • dein prog_id rendert etwas Sichtbares
  • das Event on_mounted wird ausgelöst
  • feldgesteuerte Oberfläche beginnt sich reaktiv zu verhalten

Passiert alles vier, ist die Seite in gutem Zustand. Rendert nichts, prüfe der Reihe nach: Wurde das Bundle tatsächlich geladen, passt prog_id zu einer echten Template-ID oder einem Programmschlüssel, existiert das Programm in project_data.programs, und ist das Mount-Ziel ein echtes Element (oder bewusst dem body-Fallback überlassen).