Zum Inhalt springen
Geprüft

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.

html
<div xu-exp:xu-content="'Hello ' + @first_name"></div>
<div xu-exp:class="@is_active ? 'text-green-500' : 'text-gray-500'"></div>
xu-exp:class ersetzt, es führt nicht zusammen

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:

html
<button
  xu-on:click='[
    { "handler": "custom", "workflow": [
      { "data": { "action": "update", "name": { "value": "@count_v: @count_v + 1" }, "enabled": true } }
    ] }
  ]'
>
  Increment
</button>

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 und die Geschwisterkette gibt es hier nicht

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.