Hopp til innholdet
Bekreftet

Kjøretidsdirektiver

Hele xu-*-direktivordforrådet som Slim og plattformens kjøretid deler.

Direktiver er måten Slim gjør vanlig markup, eller kjøretidsnoder, om til en reaktiv Xuda-flate. Hele skrivevokabularet er 19 attributter pluss to familier med suffiks.

Tilstand og utdata

Uttrykk

xu-exp:* evaluerer et uttrykk mot feltverdier og bruker resultatet på <attr>. Det fungerer for vanlige HTML-attributter og xu-*-attributter likt.

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 erstatter, det slår ikke sammen

xu-exp:class erstatter det statiske class-attributtet helt i stedet for å slå seg sammen med det. Hvis du trenger begge, legg de statiske klassene inn i uttrykket, eller bruk xu-class for den betingede delen og la class være i fred.

Iterasjon og betinget gjengivelse

Bruk xu-show når noden skal forbli montert og bare skjules, og xu-render når den skal fjernes fra den levende DOM-en når uttrykket er usant.

Hendelser og arbeidsflyter

xu-on:<event> tar alltid en matrise med håndteringsobjekter, som hver har en arbeidsflyt:

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

Åtte snarveisattributter normaliseres til fulle xu-on:*-arbeidsflyter for enkle feltoppdateringer, så en verdi som xu-click="count++" fungerer uten håndterings-JSON: xu-click, xu-dblclick, xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.

Avanserte direktiver

Rekkefølge

Attributter kjører i faser per element. xu-cdn, xu-style, xu-render, xu-for-key og xu-for-val kjører før noden bygges; xu-bind, xu-class, xu-script, xu-ui-plugin og xu-ref kjører etter. Den rekkefølgen er grunnen til at en xu-cdn-ressurs allerede er tilgjengelig for et xu-script på det samme elementet.

Reserverte feltnavn

Ni navn må aldri brukes som felt-ID, fordi kjøretiden tildeler dem under iterasjon og kontekstoppslag: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL.

Praktisk regel

Bruk det minste direktivet som dekker behovet: xu-text eller xu-content for enkel utdata, xu-click for en enkel oppdatering, xu-on:* for full arbeidsflytlogikk, xu-exp:* for beregnede attributter, og xu-for / xu-render / xu-show for strukturell atferd.

xu-if og søskenkjeden er ikke med her

xu-if, xu-else-if og xu-else hører til den reaktive rendereren, som bare leveres i den fulle plattformpakken. Verken Slim eller CLI-ets medfølgende kjøretid har den reaktive motoren, så bruk xu-render eller xu-show med et uttrykk på hver gren i stedet. xu-route og xu-prog er ikke direktiver i det hele tatt: de dukker opp i markedsføringsmateriell, men har ingen håndterer noe sted i kjøretiden.