Aller au contenu
Vérifié

Xuda Slim

Le point d'entrée navigateur léger vers le runtime Xuda, sans chargeur de projet.

Xuda Slim est la surface légère d'écriture et d'intégration du runtime Xuda. Elle est utile quand vous voulez la source de données réactive, les directives, les événements et les balises structurelles de Xuda, sans partir de la forme complète d'un projet Xuda CLI.

Slim reste du Xuda, pas un runtime différent. Les expressions lisent toujours les champs avec @field_name, le runtime travaille toujours à partir de documents de programme Xuda, et les balises structurelles comme xu-single-view et xu-panel comptent toujours. <template> est pris en charge, mais n'est pas obligatoire.

À quoi sert Slim

  • des pages HTML écrites à la main avec la réactivité de Xuda
  • des démos du runtime et de la documentation
  • des widgets ou micro-sites intégrables
  • des arborescences project_data de runtime générées
  • une adoption progressive de Xuda sans introduire d'abord un compilateur de sources complet

Les trois modes d'écriture

Ces modes peuvent se mélanger : si Slim reçoit project_data et que la page contient aussi des balises <template>, les templates sont analysés et ajoutés à project_data.programs à côté.

Charger le runtime

La façon prise en charge d'obtenir le bundle est le paquet npm public @xuda.io/xuda-runtime-slim-es. Si vous avez une app Xuda déployée, la plateforme sert aussi le bundle du runtime depuis le domaine de votre propre app à /cdn, avec un build non minifié à /cdn/debug.

html
<script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
Ne chargez pas depuis un hôte de développement en production

La balise script ci-dessus pointe vers un hôte de développement, utile pour essayer Slim en local. Une page déployée doit charger @xuda.io/xuda-runtime-slim-es, ou servir le bundle depuis le domaine de votre propre app à /cdn.

Le constructeur

js
new xuda(element?, options?, callback?)
new xuda.xuda(element?, options?, callback?)

Les arguments sont reconnus par leur type, pas par leur position : un élément, un objet d'options et un callback peuvent être passés dans n'importe quel ordre.

  • element : l'élément DOM dans lequel monter. Facultatif dans Slim : omettez-le et le runtime se rabat sur document.body et consigne un avertissement au lieu d'échouer.
  • options : options de session et de runtime, décrites ci-dessous.
  • callback : appelé sous la forme callback('xuda_ready', SESSION_ID, SESSION_OBJ) une fois l'app prête.

Pour savoir que le montage est terminé, le point d'accroche le plus fiable est l'événement on_mounted sur document.body :

js
document.body.addEventListener('on_mounted', () => {
  console.log('Slim page mounted');
}, { once: true });

Options courantes

Chaque option ci-dessous se résout par la même chaîne en six étapes : d'abord un paramètre de requête d'URL, puis un attribut de l'élément racine, puis options.params[key], puis options[key], puis un cookie, puis localStorage. C'est pourquoi une page Slim peut être reconfigurée depuis une chaîne de requête sans changer de code.

Comment savoir que Slim fonctionne

  • le bundle s'est chargé
  • votre prog_id affiche quelque chose de visible
  • l'événement on_mounted se déclenche
  • l'interface pilotée par les champs commence à réagir

Si les quatre se produisent, la page est en bon état. Si rien ne s'affiche, vérifiez dans l'ordre : le bundle s'est bien chargé, prog_id correspond à un vrai id de template ou à une clé de programme, le programme existe dans project_data.programs, et la cible de montage est un vrai élément (ou volontairement laissée au repli sur body).