Direktivy runtime
Úplná slovní zásoba direktiv xu-*, kterou sdílí Slim a runtime platformy.
Direktivy jsou způsob, jakým Slim mění obyčejný markup nebo uzly runtime v reaktivní povrch Xudy. Celá slovní zásoba pro psaní je 19 atributů plus dvě rodiny s příponou.
Stav a výstup
Výrazy
xu-exp:* vyhodnotí výraz nad hodnotami polí a výsledek použije na <attr>. Funguje pro běžné
atributy HTML i pro atributy xu-*.
xu-exp:class zcela nahrazuje statický atribut class, neslučuje se s ním. Pokud potřebujete
obojí, dejte statické třídy dovnitř výrazu, nebo použijte xu-class pro podmíněnou část
a class nechte být.
Iterace a podmíněné vykreslení
Použijte xu-show, když má uzel zůstat připojen a jen se skrýt, a xu-render, když se má při
nepravdivé podmínce odstranit ze živého DOM.
Události a workflow
xu-on:<event> vždy přijímá pole objektů obslužných rutin, z nichž každý nese workflow:
Osm zkrácených atributů se pro jednoduché aktualizace polí normalizuje na úplná workflow
xu-on:*, takže hodnota jako xu-click="count++" funguje bez JSON obslužné rutiny: xu-click,
xu-dblclick, xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.
Pokročilé direktivy
Pořadí
Atributy se na každém elementu spouštějí po fázích. xu-cdn, xu-style, xu-render, xu-for-key
a xu-for-val běží před sestavením uzlu; xu-bind, xu-class, xu-script, xu-ui-plugin
a xu-ref běží po něm. Proto je zdroj z xu-cdn už dostupný pro xu-script na stejném elementu.
Vyhrazené názvy polí
Devět názvů se nesmí nikdy použít jako id pole, protože je runtime přiděluje během iterace
a určování kontextu: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY,
_VAL.
Praktické pravidlo
Použijte nejmenší direktivu, která odpovídá potřebě: xu-text nebo xu-content pro jednoduchý
výstup, xu-click pro jednoduchou aktualizaci, xu-on:* pro úplnou logiku workflow, xu-exp:*
pro počítané atributy a xu-for / xu-render / xu-show pro strukturální chování.
xu-if, xu-else-if a xu-else patří reaktivnímu rendereru, dodávanému jen v plném balíčku
platformy. Ani Slim, ani runtime přibalený k CLI reaktivní engine nenesou, proto místo toho použijte
xu-render nebo xu-show s výrazem na každé větvi. xu-route a xu-prog nejsou direktivy
vůbec: objevují se v marketingových materiálech, ale nemají nikde v runtime žádnou obslužnou rutinu.