Laufzeit-Direktiven
Das vollständige xu-*-Direktiven-Vokabular, das Slim und die Plattform-Laufzeit teilen.
Direktiven sind der Weg, auf dem Slim aus einfachem Markup oder Laufzeitknoten eine reaktive Xuda-Oberfläche macht. Das gesamte Authoring-Vokabular besteht aus 19 Attributen plus zwei Familien mit Suffix.
Zustand und Ausgabe
Ausdrücke
xu-exp:* wertet einen Ausdruck gegen Feldwerte aus und wendet das Ergebnis auf <attr> an. Es funktioniert für einfache HTML-Attribute ebenso wie für xu-*-Attribute.
xu-exp:class ersetzt das statische Attribut class vollständig, statt es zusammenzuführen. Brauchst du beides, lege die statischen Klassen in den Ausdruck oder verwende xu-class für den bedingten Teil und lass class in Ruhe.
Iteration und bedingtes Rendern
Verwende xu-show, wenn der Knoten eingehängt bleiben und nur ausgeblendet werden soll, und xu-render, wenn er bei false aus dem Live-DOM entfernt werden soll.
Events und Workflows
xu-on:<event> erwartet immer ein Array von Handler-Objekten, die jeweils einen Workflow tragen:
Acht Kurzattribute werden für einfache Feld-Aktualisierungen zu vollständigen xu-on:*-Workflows normalisiert, ein Wert wie xu-click="count++" funktioniert also ohne Handler-JSON: xu-click, xu-dblclick, xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.
Erweiterte Direktiven
Reihenfolge
Attribute laufen pro Element in Phasen. xu-cdn, xu-style, xu-render, xu-for-key und xu-for-val laufen, bevor der Knoten gebaut wird; xu-bind, xu-class, xu-script, xu-ui-plugin und xu-ref laufen danach. Diese Reihenfolge ist der Grund, warum eine xu-cdn-Ressource für ein xu-script am selben Element bereits verfügbar ist.
Reservierte Feldnamen
Neun Namen dürfen nie als Feld-ID verwendet werden, weil die Laufzeit sie bei Iteration und Kontextauflösung selbst vergibt: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL.
Praktische Regel
Verwende die kleinste Direktive, die zum Bedarf passt: xu-text oder xu-content für einfache Ausgabe, xu-click für eine einfache Aktualisierung, xu-on:* für volle Workflow-Logik, xu-exp:* für berechnete Attribute und xu-for / xu-render / xu-show für strukturelles Verhalten.
xu-if, xu-else-if und xu-else gehören zum reaktiven Renderer, der nur im vollen Plattform-Bundle ausgeliefert wird. Weder Slim noch die gebündelte Laufzeit der CLI enthält die reaktive Engine, verwende also stattdessen xu-render oder xu-show mit einem Ausdruck an jedem Zweig. xu-route und xu-prog sind überhaupt keine Direktiven: Sie tauchen in Marketingmaterial auf, haben aber nirgends in der Laufzeit einen Handler.