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-*.
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 :
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, 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.