Přeskočit na obsah
Ověřeno

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-*.

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 nahrazuje, neslučuje

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:

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

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 a řetěz sourozenců tu nejsou

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.