Ugrás a tartalomhoz
Ellenőrizve

Futásidejű direktívák

A teljes xu-* direktíva-szókincs, amelyet a Slim és a platform futtatókörnyezete közösen használ.

A direktívák segítségével alakítja a Slim az egyszerű jelölést, vagy a futásidejű csomópontokat, reaktív Xuda felületté. A teljes szerzői szókincs 19 attribútum plusz két utótagos család.

Állapot és kimenet

Kifejezések

Az xu-exp:* egy kifejezést értékel ki a mezőértékek alapján, és az eredményt az <attr> attribútumra alkalmazza. Egyaránt működik egyszerű HTML-attribútumokkal és xu-* attribútumokkal.

html
<div xu-exp:xu-content="'Hello ' + @first_name"></div>
<div xu-exp:class="@is_active ? 'text-green-500' : 'text-gray-500'"></div>
Az xu-exp:class lecserél, nem fésül össze

Az xu-exp:class teljesen lecseréli a statikus class attribútumot, nem fésüli össze vele. Ha mindkettő kell, tegye a statikus osztályokat a kifejezésbe, vagy használja az xu-class direktívát a feltételes részhez, és a class attribútumot hagyja békén.

Iteráció és feltételes megjelenítés

Használja az xu-show direktívát, ha a csomópont maradjon csatolva és csak rejtőzzön el, az xu-render direktívát pedig, ha hamis érték esetén el kell távolítani az élő DOM-ból.

Események és munkafolyamatok

Az xu-on:<event> mindig kezelőobjektumok tömbjét várja, amelyek mindegyike egy munkafolyamatot hordoz:

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

Nyolc rövidített attribútum normalizálódik teljes xu-on:* munkafolyamattá egyszerű mezőfrissítésekhez, így egy olyan érték, mint az xu-click="count++", kezelő-JSON nélkül működik: xu-click, xu-dblclick, xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.

Haladó direktívák

Sorrend

Az attribútumok elemenként fázisokban futnak. Az xu-cdn, xu-style, xu-render, xu-for-key és xu-for-val a csomópont felépítése előtt fut; az xu-bind, xu-class, xu-script, xu-ui-plugin és xu-ref utána. Ezért érhető el egy xu-cdn erőforrás már egy ugyanazon az elemen lévő xu-script számára.

Fenntartott mezőnevek

Kilenc nevet soha nem szabad mezőazonosítóként használni, mert a futtatókörnyezet az iteráció és a kontextusfeloldás során maga rendeli hozzá őket: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL.

Gyakorlati szabály

Használja a legkisebb direktívát, amely megfelel az igénynek: xu-text vagy xu-content egyszerű kimenethez, xu-click egyszerű frissítéshez, xu-on:* teljes munkafolyamat-logikához, xu-exp:* számított attribútumokhoz, és xu-for / xu-render / xu-show szerkezeti viselkedéshez.

Az xu-if és a testvérlánc nincs itt

Az xu-if, xu-else-if és xu-else a reaktív megjelenítőhöz tartozik, amelyet csak a teljes platform csomag szállít. Sem a Slim, sem a CLI beépített futtatókörnyezete nem tartalmazza a reaktív motort, ezért használja helyette az xu-render vagy xu-show direktívát egy-egy kifejezéssel minden ágon. Az xu-route és az xu-prog egyáltalán nem direktíva: marketinganyagokban szerepelnek, de a futtatókörnyezetben sehol nincs hozzájuk kezelő.