Rotta
Un punto di ingresso navigabile, un menu di destinazioni, ciascuna che punta al componente che ne fornisce il contenuto.
Una Rotta definisce una superficie navigabile di un'app Xuda: un menu di destinazioni, ciascuna un percorso o un'etichetta associata al Componente che la visualizza. Le Rotte vivono in un ramo proprio dell'albero di Studio, separato da Programmi e Database, e una singola app può dichiararne diverse, un sito pubblico, una dashboard di amministrazione, una shell mobile, ciascuna come proprio documento Rotta.
Proprietà
studio_meta.parentId ha come valore predefinito routes, la radice dell'albero Rotte. A differenza di Programmi e Database, l'albero Rotte non ha cartelle annidate: ogni Rotta sta direttamente sotto quella radice.
La lista consentita properties.menuType del controllo (CHK_MSG_OBJ_GEN_105) omette route, quindi ogni documento Rotta genera "invalid properties.menuType" nell'elenco dei problemi, anche se check_route esegue accanto ad essa i propri controlli reali (CHK_MSG_RTE_MNU_010/020/030). Non impedisce di salvare o distribuire una rotta: è un rumore che ci si può aspettare e ignorare nell'output del controllo, non il segno che la rotta sia configurata male.
routeMenu
Ogni voce di menu ha bisogno di un prog_id che indichi il Componente che ne fornisce il contenuto: se manca, o se indica un programma che il progetto non ha, è un errore del controllo. Le voci possono annidarsi (children) e ognuna porta campi di visualizzazione come bgColor / bgTextColor per il suo stato attivo, compilati dall'editor delle Rotte.
Esempio pratico
Elenca le destinazioni
Una voce di menu per schermata: un titolo e il _id del Componente che apre.
Scegli una voce predefinita
default_menu_id indica la voce mostrata quando la rotta viene aperta per la prima volta.
Punta un Componente verso di essa
La maggior parte delle app rispecchia la rotta anche come interfaccia di navigazione vera e propria (schede, una barra laterale), con l'xu-on:click di ogni pulsante che chiama call_page con l'id del Componente di destinazione, così la rotta resta la fonte di verità e l'interfaccia resta sincronizzata con essa.
Sotto Rotte nell'albero di Studio, aggiungi una rotta, poi costruisci il suo menu nell'editor delle Rotte: aggiungi una voce, dalle un'etichetta e scegli il Componente che deve aprire.
Una rotta non ha una forma sorgente .xu: i progetti xuda-cli la dichiarano invece come file .route.json5. La sua chiave semplice prog viene compilata in routeMenu.menu[].prog_id nel documento Studio.