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_datade 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.
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
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 surdocument.bodyet consigne un avertissement au lieu d'échouer.options: options de session et de runtime, décrites ci-dessous.callback: appelé sous la formecallback('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 :
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_idaffiche quelque chose de visible - l'événement
on_mountedse 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).