Saltar para o conteúdo
Verificado

Rota

Um ponto de entrada navegável, um menu de destinos, cada um a apontar para o componente que fornece o seu conteúdo.

Uma Rota define uma superfície navegável de uma aplicação Xuda: um menu de destinos, cada um deles um caminho ou uma etiqueta mapeada para o Componente que o renderiza. As Rotas vivem no seu próprio ramo da árvore do Studio, separado de Programas e Base de dados, e uma só aplicação pode declarar várias, um site público, um painel de administração, uma shell móvel, cada uma com o seu próprio documento de Rota.

Propriedades

studio_meta.parentId assume por predefinição routes, a raiz da árvore de Rotas. Ao contrário de Programas e Base de dados, a árvore de Rotas não tem aninhamento de pastas, todas as Rotas ficam diretamente sob essa raiz.

Todos os documentos de Rota geram hoje um erro de verificação

A lista de permissões properties.menuType do verificador (CHK_MSG_OBJ_GEN_105) omite route, pelo que todos os documentos de Rota levantam "invalid properties.menuType" na lista de problemas, embora check_route execute as suas próprias verificações reais (CHK_MSG_RTE_MNU_010/020/030) logo ao lado. Não impede guardar nem implementar uma rota, é ruído que se deve esperar e ignorar na saída do verificador, não um sinal de que a rota está mal configurada.

routeMenu

Cada entrada em menu precisa de um prog_id com o nome do Componente que fornece o seu conteúdo; omiti-lo, ou indicar um programa que o projeto não tem, é um erro do verificador. Os itens podem aninhar-se (children) e cada um leva campos de apresentação como bgColor / bgTextColor para o seu estado ativo, preenchidos pelo editor de Rotas.

Exemplo prático

Liste os destinos

Uma entrada de menu por ecrã: um título e o _id do Componente que abre.

Escolha um predefinido

default_menu_id indica a entrada mostrada quando a rota é aberta pela primeira vez.

Aponte um Componente para ela

A maioria das aplicações espelha a rota também como interface de navegação literal (separadores, uma barra lateral), com o xu-on:click de cada botão a chamar call_page com o id do Componente de destino, para que a rota continue a ser a fonte de verdade e a interface fique sincronizada com ela.

Em Rotas, na árvore do Studio, adicione uma rota e depois construa o seu menu no editor de Rotas: adicione um item, dê-lhe uma etiqueta e escolha o Componente que deve 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" }
  ]
}

Uma rota não tem forma de código-fonte .xu, os projetos xuda-cli declaram-na antes como um ficheiro .route.json5. A sua chave amigável prog compila para routeMenu.menu[].prog_id no documento do 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" }
    ]
  }
}