Directive de runtime
Vocabularul complet de directive xu-* pe care îl împart Slim și runtime-ul platformei.
Directivele sunt modul în care Slim transformă markup simplu, sau noduri de runtime, într-o suprafață Xuda reactivă. Întregul vocabular de creare înseamnă 19 atribute plus două familii cu sufix.
Stare și output
Expresii
xu-exp:* evaluează o expresie față de valorile câmpurilor și aplică rezultatul pe <attr>. Funcționează
atât pentru atribute HTML simple, cât și pentru atribute xu-*.
xu-exp:class înlocuiește complet atributul static class, în loc să se îmbine cu el. Dacă
ai nevoie de ambele, pune clasele statice în expresie sau folosește xu-class pentru partea condițională
și lasă class în pace.
Iterare și randare condiționată
Folosește xu-show când nodul trebuie să rămână montat și doar să se ascundă și xu-render când trebuie
eliminat din DOM-ul live când condiția este falsă.
Evenimente și fluxuri de lucru
xu-on:<event> primește întotdeauna un array de obiecte handler, fiecare purtând un flux de lucru:
Opt atribute prescurtate se normalizează în fluxuri de lucru xu-on:* complete pentru actualizări simple de câmp, așa că o
valoare precum xu-click="count++" funcționează fără JSON de handler: xu-click, xu-dblclick,
xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.
Directive avansate
Ordinea
Atributele rulează în faze pentru fiecare element. xu-cdn, xu-style, xu-render, xu-for-key și
xu-for-val rulează înainte ca nodul să fie construit; xu-bind, xu-class, xu-script, xu-ui-plugin și
xu-ref rulează după. Din această ordine o resursă xu-cdn este deja disponibilă pentru un
xu-script de pe același element.
Nume de câmp rezervate
Nouă nume nu trebuie folosite niciodată ca id de câmp, pentru că runtime-ul le atribuie în timpul iterării și al
rezolvării contextului: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY,
_VAL.
Regula practică
Folosește cea mai mică directivă care se potrivește nevoii: xu-text sau xu-content pentru output simplu,
xu-click pentru o actualizare simplă, xu-on:* pentru logică completă de flux de lucru, xu-exp:* pentru atribute
calculate și xu-for / xu-render / xu-show pentru comportament structural.
xu-if, xu-else-if și xu-else aparțin renderer-ului reactiv, livrat doar în bundle-ul complet
al platformei. Nici Slim, nici runtime-ul inclus în CLI nu au motorul reactiv, așa că folosește
în schimb xu-render sau xu-show cu o expresie pe fiecare ramură. xu-route și xu-prog nu sunt
deloc directive: apar în materiale de marketing, dar nu au niciun handler nicăieri în runtime.