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å.
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:
Å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, 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.