Preskočiť na obsah
Overené

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

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 nahrádza, nezlučuje

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:

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

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 a reťazec súrodencov tu nie sú

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.