Direktívy runtime
Úplná slovná zásoba direktív xu-*, ktorú zdieľajú Slim a runtime platformy.
Direktívy sú spôsob, akým Slim mení obyčajné značkovanie alebo uzly runtime na reaktívny povrch Xuda. Celá slovná zásoba tvorby má 19 atribútov plus dve rodiny s príponou.
Stav a výstup
Výrazy
xu-exp:* vyhodnotí výraz nad hodnotami polí a výsledok použije na <attr>. Funguje rovnako pre
obyčajné atribúty HTML aj pre atribúty xu-*.
xu-exp:class úplne nahradí statický atribút class, nezlučuje sa s ním. Ak potrebujete oboje,
dajte statické triedy do výrazu alebo použite xu-class pre podmienenú časť a class nechajte
tak.
Iterácia a podmienené vykresľovanie
Použite xu-show, keď má uzol zostať pripojený a len sa skryť, a xu-render, keď sa má pri
nepravde odstrániť zo živého DOM.
Udalosti a pracovné postupy
xu-on:<event> vždy berie pole objektov handlerov, z ktorých každý nesie pracovný postup:
Osem skrátených atribútov sa normalizuje na úplné pracovné postupy xu-on:* pre jednoduché
aktualizácie polí, takže hodnota ako xu-click="count++" funguje bez JSON handlera: xu-click,
xu-dblclick, xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.
Pokročilé direktívy
Poradie
Atribúty sa na každom elemente vykonávajú vo fázach. xu-cdn, xu-style, xu-render, xu-for-key a
xu-for-val bežia pred zostavením uzla; xu-bind, xu-class, xu-script, xu-ui-plugin a
xu-ref bežia po ňom. Vďaka tomu poradiu je zdroj z xu-cdn už dostupný pre xu-script na tom
istom elemente.
Vyhradené názvy polí
Deväť názvov sa nesmie nikdy použiť ako id poľa, pretože ich runtime priraďuje počas iterácie a
určovania kontextu: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY,
_VAL.
Praktické pravidlo
Použite najmenšiu direktívu, ktorá zodpovedá potrebe: xu-text alebo xu-content pre jednoduchý
výstup, xu-click pre jednoduchú aktualizáciu, xu-on:* pre úplnú logiku pracovného postupu,
xu-exp:* pre vypočítané atribúty a xu-for / xu-render / xu-show pre štrukturálne správanie.
xu-if, xu-else-if a xu-else patria reaktívnemu rendereru, ktorý sa dodáva iba v úplnom balíku
platformy. Ani Slim, ani balíkovaný runtime CLI reaktívny engine nenesie, takže namiesto toho použite
xu-render alebo xu-show s výrazom na každej vetve. xu-route a xu-prog nie sú direktívy vôbec:
objavujú sa v marketingových materiáloch, ale v runtime nemajú nikde handler.