Aller au contenu
Vérifié

Route

Un point d'entrée navigable, un menu de destinations, chacune pointant vers le composant qui fournit son contenu.

Une Route définit une surface navigable d'une application Xuda : un menu de destinations, chacune étant un chemin ou un libellé associé au Composant qui l'affiche. Les Routes vivent dans leur propre branche de l'arborescence de Studio, séparée de Programmes et de Base de données, et une même application peut en déclarer plusieurs, un site public, un tableau de bord d'administration, une enveloppe mobile, chacune étant son propre document Route.

Propriétés

studio_meta.parentId vaut par défaut routes, la racine de l'arborescence des Routes. Contrairement à Programmes et à Base de données, l'arborescence des Routes n'a pas de dossiers imbriqués : chaque Route se place directement sous cette racine.

Chaque document Route est signalé comme une erreur aujourd'hui

La liste autorisée properties.menuType du vérificateur (CHK_MSG_OBJ_GEN_105) omet route, donc chaque document Route lève « invalid properties.menuType » dans la liste des problèmes, alors même que check_route exécute ses propres vérifications réelles (CHK_MSG_RTE_MNU_010/020/030) juste à côté. Cela n'empêche ni d'enregistrer ni de déployer une route : c'est du bruit à prévoir et à ignorer dans la sortie du vérificateur, pas le signe d'une route mal configurée.

routeMenu

Chaque entrée de menu a besoin d'un prog_id nommant le Composant qui fournit son contenu : l'omettre, ou nommer un programme que le projet n'a pas, est une erreur du vérificateur. Les éléments peuvent s'imbriquer (children), et chacun porte des champs d'affichage comme bgColor / bgTextColor pour son état actif, renseignés par l'éditeur de Routes.

Exemple concret

Listez les destinations

Une entrée de menu par écran : un titre, et le _id du Composant qu'elle ouvre.

Choisissez une valeur par défaut

default_menu_id nomme l'entrée affichée à la première ouverture de la route.

Pointez un Composant dessus

La plupart des applications reproduisent aussi la route dans une interface de navigation littérale (onglets, barre latérale), le xu-on:click de chaque bouton appelant call_page avec l'identifiant du Composant cible, de sorte que la route reste la source de vérité et que l'interface reste synchronisée avec elle.

Sous Routes dans l'arborescence de Studio, ajoutez une route, puis construisez son menu dans l'éditeur de Routes : ajoutez un élément, donnez-lui un libellé et choisissez le Composant qu'il doit ouvrir.

json
{
  "id": "student_app_route",
  "menuTitle": "Student Dashboard Route",
  "menu": [
    { "title": "Login", "prog": "app" },
    { "title": "Students", "prog": "student_classes" },
    { "title": "Tasks", "prog": "student_tasks" }
  ]
}

Une route n'a pas de forme source .xu : les projets xuda-cli la déclarent plutôt dans un fichier .route.json5. Sa clé conviviale prog se compile en routeMenu.menu[].prog_id dans le document Studio.

json
{
  "properties": { "menuType": "route", "menuName": "Admin Dashboard" },
  "routeMenu": {
    "default_menu_id": "a1b2c3d4-…",
    "menu": [
      { "id": "a1b2c3d4-…", "prog_id": "97a_cmp_…", "bgColor": "#0f172a", "bgTextColor": "#f8fafc" },
      { "id": "b2c3d4e5-…", "prog_id": "97a_cmp_…", "bgColor": "#1e293b", "bgTextColor": "#e2e8f0" }
    ]
  }
}