Le langage .xu
Le format de blocs dans lequel s'écrit chaque fichier source .xu, et les onze éléments de base dont un projet est fait.
Un fichier .xu est un fichier de blocs, pas un module JavaScript. Chaque bloc correspond à une préoccupation, et les blocs d'objet (<meta>, <params>, <fields>, <actions>, <events>, <datasource>) sont analysés comme des littéraux de style JSON5 : clés sans guillemets, tableaux et objets imbriqués sont tous acceptés.
Onze éléments de base
Le dossier où se trouve un fichier source détermine le type d'unité vers lequel il se compile. Une bonne app Xu se lit généralement plus clairement quand chaque préoccupation a sa propre unité plutôt qu'un seul fichier qui fait tout.
App.xu est le seul fichier réservé : c'est toujours l'app racine et il se compile toujours vers l'identifiant de programme app. Pour un fichier component, l'identifiant se résout dans l'ordre à partir de meta.id, puis mount.id, puis du nom de base du fichier. Tous les autres types d'unité n'ont pas de bloc <mount>, donc leur identifiant se résout à partir de meta.id, puis du nom de base du fichier. Pour les ressources JSON5, l'ordre est id, puis _id, puis le nom de base. Les identifiants en double dans un projet ne sont pas autorisés.
Blocs par type d'unité
App.xu n'a jamais besoin d'un bloc <mount>. Un composant ordinaire n'en a besoin que si vous voulez le monter directement dans une page HTML plutôt que de l'atteindre via <panel program="..."> :
Le langage de template
Dans <template>, un petit ensemble d'alias pratiques se compile vers le balisage xu-* propre au runtime.
Un composant, de bout en bout
<script> se compile en un module de montage côté client : l'export par défaut reçoit un objet de contexte et peut renvoyer une fonction de nettoyage à exécuter au déchargement. Les blocs <style> sont rassemblés en une seule feuille de style de composant servie.
Format de source de données
Utilisez la forme d'enveloppe lisible dans <datasource lang="json5">. type vaut none, table, array, json ou csv.
Une source de données de type table utilise table, filter, sort, direction, realtime, limit, skip et output. Une source de données de type tableau, JSON ou CSV utilise source.field ou source.url. Pour toute clé de source de données que la forme d'enveloppe n'expose pas, passez à mode="raw" et écrivez les noms de champs qu'utilise le document du runtime lui-même.
Les dix autres blocs, en bref
Des lectures nommées et réutilisables. data/get/LoadStudentClasses.xu associe <params> (champs in/out déclarés) à une <datasource>, donc un composant appelle un chargeur par son nom au lieu de gérer lui-même les détails de la requête.
Des écritures nommées. data/set/SaveStudentProfile.xu ajoute crudMode et allowCreate à <meta> à côté des paramètres et de la source de données, ce qui donne à la persistance un emplacement visible et testable dans la source.
Traitement enregistrement par enregistrement. data/batch/RebuildClassRoster.xu exécute une étape <events> comme before_record sur chaque ligne que résout la <datasource>.
Un bloc <response> transforme les paramètres, les résultats de la source de données et les événements en une charge utile de style JSON :
Une transformation nommée et réutilisable. <code> s'exécute comme un corps de fonction sur les paramètres in déclarés et renvoie la valeur out :
Une définition de message réutilisable, référencée depuis un workflow au lieu d'être écrite en ligne à chaque fois :
Les routes décrivent comment les composants sont présentés sous forme d'app navigable ; elles ne remplacent pas les composants eux-mêmes.
Un exemple complet
xuda-studant-app-example est une arborescence source complète qui couvre les onze blocs : un parcours de connexion, un tableau de bord avec routes, des écrans de liste d'étudiants, de tâches et de profil, des lectures et écritures adossées à des tables, et un style Tailwind. Décompressez-la avec :
Tout ce qui précède est le dialecte interprété que compile xuda-cli : des blocs analysés à l'enregistrement vers des documents de runtime progUi / progFields / progEvents, lus par le moteur de rendu piloté par expressions de la plateforme. Un compilateur distinct et non publié (@xuda/compiler, utilisé par vite-plugin-xu) lit un fichier .xu plus restreint, composé uniquement de <template>, <script> et <style>, ignore les noms de blocs ci-dessus et produit à l'avance un vrai module ES au lieu d'un document JSON. Il cible le moteur de rendu plus récent, à base de signaux, de @xuda/core, le même moteur que la plateforme livre sous runtime/js/xuda_core.globals.js. Voir vite-plugin-xu et @xuda/core pour cette voie.