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.
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:
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, 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.