Naar de inhoud springen
Geverifieerd

Runtime-directives

Het volledige xu-*-directivevocabulaire dat Slim en de platformruntime delen.

Met directives maakt Slim van gewone markup, of van runtime-nodes, een reactief Xuda-oppervlak. Het hele schrijfvocabulaire bestaat uit 19 attributen plus twee families met een achtervoegsel.

State en uitvoer

Expressies

xu-exp:* evalueert een expressie op veldwaarden en past het resultaat toe op <attr>. Het werkt voor gewone HTML-attributen en voor xu-*-attributen.

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 vervangt, het voegt niet samen

xu-exp:class vervangt het statische class-attribuut volledig in plaats van ermee samen te voegen. Heb je beide nodig, zet de statische klassen dan in de expressie, of gebruik xu-class voor het voorwaardelijke deel en laat class met rust.

Iteratie en voorwaardelijk renderen

Gebruik xu-show als de node gemount moet blijven en alleen verborgen wordt, en xu-render als hij uit de live DOM moet worden verwijderd wanneer de conditie onwaar is.

Events en workflows

xu-on:<event> neemt altijd een array van handler-objecten, elk met een workflow:

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

Acht afkortingsattributen worden genormaliseerd tot volledige xu-on:*-workflows voor eenvoudige veldupdates, zodat een waarde als xu-click="count++" werkt zonder handler-JSON: xu-click, xu-dblclick, xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.

Geavanceerde directives

Volgorde

Attributen worden per element in fasen uitgevoerd. xu-cdn, xu-style, xu-render, xu-for-key en xu-for-val draaien voordat de node wordt gebouwd; xu-bind, xu-class, xu-script, xu-ui-plugin en xu-ref draaien erna. Daarom is een xu-cdn-bron al beschikbaar voor een xu-script op hetzelfde element.

Gereserveerde veldnamen

Negen namen mag je nooit als veld-id gebruiken, omdat de runtime ze toewijst tijdens iteratie en contextresolutie: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL.

Praktische regel

Gebruik de kleinste directive die bij de behoefte past: xu-text of xu-content voor eenvoudige uitvoer, xu-click voor een eenvoudige update, xu-on:* voor volledige workflowlogica, xu-exp:* voor berekende attributen, en xu-for / xu-render / xu-show voor structureel gedrag.

xu-if en de sibling-keten staan hier niet

xu-if, xu-else-if en xu-else horen bij de reactieve renderer, die alleen in de volledige platformbundel zit. Noch Slim noch de gebundelde runtime van de CLI bevat de reactieve engine, gebruik dus xu-render of xu-show met een expressie op elke tak. xu-route en xu-prog zijn helemaal geen directives: ze staan in marketingmateriaal, maar hebben nergens in de runtime een handler.