Hoppa till innehållet
Verifierad

Runtime-direktiv

Hela xu-*-direktivvokabulären som Slim och plattformens runtime delar.

Direktiv är hur Slim förvandlar vanlig markup, eller runtime-noder, till en reaktiv Xuda-yta. Hela skrivvokabulären är 19 attribut plus två familjer med suffix.

Tillstånd och utdata

Uttryck

xu-exp:* utvärderar ett uttryck mot fältvärden och tillämpar resultatet på <attr>. Det fungerar för vanliga HTML-attribut och xu-*-attribut likaså.

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 ersätter, det slår inte ihop

xu-exp:class ersätter det statiska class-attributet helt i stället för att slå ihop med det. Om du behöver båda, lägg de statiska klasserna inuti uttrycket, eller använd xu-class för den villkorliga delen och lämna class ifred.

Iteration och villkorlig rendering

Använd xu-show när noden ska förbli monterad och bara döljas, och xu-render när den ska tas bort från den levande DOM när villkoret är falskt.

Händelser och arbetsflöden

xu-on:<event> tar alltid en array av hanterarobjekt, där varje objekt bär ett arbetsflöde:

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

Åtta förkortade attribut normaliseras till fullständiga xu-on:*-arbetsflöden för enkla fältuppdateringar, så ett värde som xu-click="count++" fungerar utan hanterar-JSON: xu-click, xu-dblclick, xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.

Avancerade direktiv

Ordning

Attribut körs i faser per element. xu-cdn, xu-style, xu-render, xu-for-key och xu-for-val körs innan noden byggs; xu-bind, xu-class, xu-script, xu-ui-plugin och xu-ref körs efter. Den ordningen är anledningen till att en xu-cdn-resurs redan är tillgänglig för ett xu-script på samma element.

Reserverade fältnamn

Nio namn får aldrig användas som fält-id, eftersom runtime tilldelar dem under iteration och kontextupplösning: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL.

Praktisk regel

Använd det minsta direktiv som passar behovet: xu-text eller xu-content för enkel utdata, xu-click för en enkel uppdatering, xu-on:* för fullständig arbetsflödeslogik, xu-exp:* för beräknade attribut och xu-for / xu-render / xu-show för strukturellt beteende.

xu-if och syskonkedjan finns inte här

xu-if, xu-else-if och xu-else tillhör den reaktiva renderaren, som bara levereras i det fullständiga plattformspaketet. Varken Slim eller CLI:ns medföljande runtime har den reaktiva motorn, så använd xu-render eller xu-show med ett uttryck på varje gren i stället. xu-route och xu-prog är inte direktiv alls: de förekommer i marknadsföringsmaterial men har ingen hanterare någonstans i runtime.