Saltar al contenido
Verificada

Ruta

Un punto de entrada navegable, un menú de destinos, cada uno apuntando al componente que aporta su contenido.

Una Ruta define una superficie navegable de una app de Xuda: un menú de destinos, cada uno una ruta o una etiqueta asignada al Componente que la renderiza. Las Rutas viven en su propia rama del árbol de Studio, separada de Programas y Base de datos, y una misma app puede declarar varias, un sitio público, un panel de administración, un shell móvil, cada una como su propio documento Ruta.

Propiedades

studio_meta.parentId es por defecto routes, la raíz del árbol de Rutas. A diferencia de Programas y Base de datos, el árbol de Rutas no admite carpetas anidadas, cada Ruta está directamente bajo esa raíz.

Hoy todos los documentos Ruta dan un error en el análisis

La lista de valores permitidos de properties.menuType del comprobador (CHK_MSG_OBJ_GEN_105) omite route, así que cada documento Ruta genera "invalid properties.menuType" en la lista de problemas aunque check_route ejecute sus propias comprobaciones reales (CHK_MSG_RTE_MNU_010/020/030) justo a su lado. No impide guardar ni desplegar una ruta; es ruido que conviene esperar e ignorar en la salida del comprobador, no una señal de que la ruta esté mal configurada.

routeMenu

Cada entrada de menu necesita un prog_id que nombre el Componente que aporta su contenido; si falta, o nombra un programa que el proyecto no tiene, es un error del comprobador. Los elementos pueden anidarse (children) y cada uno lleva campos de visualización como bgColor / bgTextColor para su estado activo, rellenados por el editor de Rutas.

Ejemplo práctico

Lista los destinos

Una entrada de menú por pantalla: un título y el _id del Componente que abre.

Elige uno por defecto

default_menu_id nombra la entrada que se muestra cuando la ruta se abre por primera vez.

Apunta un Componente a ella

La mayoría de las apps también reflejan la ruta como interfaz de navegación literal (pestañas, una barra lateral), con el xu-on:click de cada botón llamando a call_page con el id del Componente de destino, de modo que la ruta sigue siendo la fuente de verdad y la interfaz se mantiene sincronizada con ella.

En Rutas, en el árbol de Studio, añade una ruta y luego construye su menú en el editor de Rutas: añade un elemento, ponle una etiqueta y elige el Componente que debe abrir.

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

Una ruta no tiene forma de código fuente .xu; los proyectos de xuda-cli la declaran como un archivo .route.json5. Su clave sencilla prog se compila a routeMenu.menu[].prog_id en el documento de 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" }
    ]
  }
}