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.
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.
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.