Gå til indhold
Bekræftet

Runtime-direktiver

Hele xu-*-direktivordforrådet, som Slim og platformens runtime deler.

Direktiver er den måde, Slim gør almindelig markup, eller runtime-noder, til en reaktiv Xuda-flade på. Hele skriveordforrådet er 19 attributter plus to familier med suffiks.

Tilstand og output

Udtryk

xu-exp:* evaluerer et udtryk mod feltværdier og anvender resultatet på <attr>. Det virker både for almindelige HTML-attributter og for xu-*-attributter.

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, den fletter ikke

xu-exp:class erstatter den statiske class-attribut helt i stedet for at flette med den. Hvis du har brug for begge, så læg de statiske klasser inde i udtrykket, eller brug xu-class til den betingede del og lad class være.

Iteration og betinget rendering

Brug xu-show, når noden skal forblive monteret og blot skjules, og xu-render, når den skal fjernes fra den levende DOM, når udtrykket er falsk.

Hændelser og workflows

xu-on:<event> tager altid et array af handler-objekter, der hver bærer en workflow:

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

Otte genvejsattributter normaliseres til fulde xu-on:*-workflows til simple feltopdateringer, så en værdi som xu-click="count++" virker uden handler-JSON: xu-click, xu-dblclick, xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.

Avancerede direktiver

Rækkefølge

Attributter køres i faser pr. element. xu-cdn, xu-style, xu-render, xu-for-key og xu-for-val køres, før noden bygges. xu-bind, xu-class, xu-script, xu-ui-plugin og xu-ref køres efter. Den rækkefølge er grunden til, at en xu-cdn-ressource allerede er tilgængelig for et xu-script på det samme element.

Reserverede feltnavne

Ni navne må aldrig bruges som felt-id, fordi runtime tildeler dem under iteration og kontekstløsning: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL.

Praktisk regel

Brug det mindste direktiv, der passer til behovet: xu-text eller xu-content til simpelt output, xu-click til en simpel opdatering, xu-on:* til fuld workflow-logik, xu-exp:* til beregnede attributter og xu-for / xu-render / xu-show til strukturel adfærd.

xu-if og søskendekæden er ikke med her

xu-if, xu-else-if og xu-else hører til den reaktive renderer, som kun leveres i det fulde platformsbundle. Hverken Slim eller CLI'ens medfølgende runtime har den reaktive motor, så brug xu-render eller xu-show med et udtryk på hver gren i stedet. xu-route og xu-prog er slet ikke direktiver: de optræder i markedsføringsmateriale, men har ingen handler nogen steder i runtime.