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.
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
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 aufdocument.bodyzurück und protokolliert eine Warnung, statt zu scheitern.options: Sitzungs- und Laufzeitoptionen, unten behandelt.callback: wird alscallback('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:
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_idrendert etwas Sichtbares - das Event
on_mountedwird 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).