Aller au contenu
Vérifié

Directives du runtime

Le vocabulaire complet des directives xu-* que Slim et le runtime de la plateforme partagent.

Les directives sont la façon dont Slim transforme du balisage ordinaire, ou des nœuds de runtime, en une surface Xuda réactive. Tout le vocabulaire d'écriture compte 19 attributs plus deux familles à suffixe.

État et sortie

Expressions

xu-exp:* évalue une expression à partir des valeurs de champs et applique le résultat à <attr>. Cela fonctionne aussi bien pour les attributs HTML ordinaires que pour les attributs 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 remplace, il ne fusionne pas

xu-exp:class remplace entièrement l'attribut class statique au lieu de s'y fusionner. Si vous avez besoin des deux, mettez les classes statiques dans l'expression, ou utilisez xu-class pour la partie conditionnelle et laissez class tranquille.

Itération et rendu conditionnel

Utilisez xu-show quand le nœud doit rester monté et simplement se masquer, et xu-render quand il doit être retiré du DOM actif quand la condition est fausse.

Événements et workflows

xu-on:<event> prend toujours un tableau d'objets gestionnaires, chacun portant un workflow :

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

Huit attributs raccourcis se normalisent en workflows xu-on:* complets pour de simples mises à jour de champs, donc une valeur comme xu-click="count++" fonctionne sans JSON de gestionnaire : xu-click, xu-dblclick, xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.

Directives avancées

Ordre

Les attributs s'exécutent par phases pour chaque élément. xu-cdn, xu-style, xu-render, xu-for-key et xu-for-val s'exécutent avant la construction du nœud ; xu-bind, xu-class, xu-script, xu-ui-plugin et xu-ref s'exécutent après. C'est cet ordre qui explique qu'une ressource xu-cdn soit déjà disponible pour un xu-script sur le même élément.

Noms de champs réservés

Neuf noms ne doivent jamais être utilisés comme id de champ, parce que le runtime les attribue pendant l'itération et la résolution du contexte : _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL.

Règle pratique

Utilisez la plus petite directive qui répond au besoin : xu-text ou xu-content pour une sortie simple, xu-click pour une simple mise à jour, xu-on:* pour une logique de workflow complète, xu-exp:* pour des attributs calculés, et xu-for / xu-render / xu-show pour le comportement structurel.

xu-if et la chaîne de frères ne sont pas ici

xu-if, xu-else-if et xu-else appartiennent au moteur de rendu réactif, livré uniquement dans le bundle complet de la plateforme. Ni Slim ni le runtime embarqué du CLI ne contiennent le moteur réactif, donc utilisez plutôt xu-render ou xu-show avec une expression sur chaque branche. xu-route et xu-prog ne sont pas du tout des directives : ils apparaissent dans des documents marketing mais n'ont aucun gestionnaire nulle part dans le runtime.