Sari la conținut
Verificat

Directive de runtime

Vocabularul complet de directive xu-* pe care îl împart Slim și runtime-ul platformei.

Directivele sunt modul în care Slim transformă markup simplu, sau noduri de runtime, într-o suprafață Xuda reactivă. Întregul vocabular de creare înseamnă 19 atribute plus două familii cu sufix.

Stare și output

Expresii

xu-exp:* evaluează o expresie față de valorile câmpurilor și aplică rezultatul pe <attr>. Funcționează atât pentru atribute HTML simple, cât și pentru atribute 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 înlocuiește, nu îmbină

xu-exp:class înlocuiește complet atributul static class, în loc să se îmbine cu el. Dacă ai nevoie de ambele, pune clasele statice în expresie sau folosește xu-class pentru partea condițională și lasă class în pace.

Iterare și randare condiționată

Folosește xu-show când nodul trebuie să rămână montat și doar să se ascundă și xu-render când trebuie eliminat din DOM-ul live când condiția este falsă.

Evenimente și fluxuri de lucru

xu-on:<event> primește întotdeauna un array de obiecte handler, fiecare purtând un flux de lucru:

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

Opt atribute prescurtate se normalizează în fluxuri de lucru xu-on:* complete pentru actualizări simple de câmp, așa că o valoare precum xu-click="count++" funcționează fără JSON de handler: xu-click, xu-dblclick, xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.

Directive avansate

Ordinea

Atributele rulează în faze pentru fiecare element. xu-cdn, xu-style, xu-render, xu-for-key și xu-for-val rulează înainte ca nodul să fie construit; xu-bind, xu-class, xu-script, xu-ui-plugin și xu-ref rulează după. Din această ordine o resursă xu-cdn este deja disponibilă pentru un xu-script de pe același element.

Nume de câmp rezervate

Nouă nume nu trebuie folosite niciodată ca id de câmp, pentru că runtime-ul le atribuie în timpul iterării și al rezolvării contextului: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL.

Regula practică

Folosește cea mai mică directivă care se potrivește nevoii: xu-text sau xu-content pentru output simplu, xu-click pentru o actualizare simplă, xu-on:* pentru logică completă de flux de lucru, xu-exp:* pentru atribute calculate și xu-for / xu-render / xu-show pentru comportament structural.

xu-if și lanțul de frați nu sunt aici

xu-if, xu-else-if și xu-else aparțin renderer-ului reactiv, livrat doar în bundle-ul complet al platformei. Nici Slim, nici runtime-ul inclus în CLI nu au motorul reactiv, așa că folosește în schimb xu-render sau xu-show cu o expresie pe fiecare ramură. xu-route și xu-prog nu sunt deloc directive: apar în materiale de marketing, dar nu au niciun handler nicăieri în runtime.