Trasa
Navigovateľný vstupný bod, menu cieľov, z ktorých každý ukazuje na komponent, ktorý poskytuje jeho obsah.
Trasa definuje navigovateľný povrch aplikácie Xuda: menu cieľov, z ktorých každý je cesta alebo označenie priradené Komponentu, ktorý ho vykresľuje. Trasy žijú vo vlastnej vetve stromu Studia, oddelenej od Programov a Databázy, a jedna aplikácia ich môže deklarovať viac, verejný web, administračný dashboard, mobilný obal, každú ako vlastný dokument Trasy.
Vlastnosti
studio_meta.parentId je predvolene routes, koreň stromu Trás. Na rozdiel od Programov a Databázy strom Trás nemá vnorenie do priečinkov, každá Trasa sedí priamo pod týmto koreňom.
Zoznam povolených hodnôt properties.menuType v kontrole (CHK_MSG_OBJ_GEN_105) vynecháva route, takže každý dokument Trasy vyvolá v zozname problémov "invalid properties.menuType", hoci check_route vykonáva vlastné, skutočné kontroly (CHK_MSG_RTE_MNU_010/020/030) hneď vedľa. Neblokuje to uloženie ani nasadenie trasy, je to šum, ktorý treba v výstupe kontroly očakávať a ignorovať, nie znak, že trasa je zle nastavená.
routeMenu
Každý záznam v menu potrebuje prog_id, ktoré pomenúva Komponent poskytujúci jeho obsah; ak chýba alebo pomenúva program, ktorý projekt nemá, je to chyba kontroly. Položky sa môžu vnárať (children) a každá nesie zobrazovacie polia ako bgColor / bgTextColor pre svoj aktívny stav, vyplnené editorom Trás.
Ukážkový príklad
Uveďte ciele
Jeden záznam menu na obrazovku: názov a _id Komponentu, ktorý otvára.
Vyberte predvolený
default_menu_id pomenúva záznam zobrazený pri prvom otvorení trasy.
Nasmerujte naň Komponent
Väčšina aplikácií zrkadlí trasu aj ako doslovné navigačné UI (karty, bočný panel), pričom xu-on:click každého tlačidla volá call_page s id cieľového Komponentu, takže trasa zostáva zdrojom pravdy a UI s ňou zostáva v súlade.
Pod Trasami v strome Studia pridajte trasu a potom zostavte jej menu v editore Trás: pridajte položku, dajte jej označenie a vyberte Komponent, ktorý má otvoriť.
Trasa nemá zdrojovú formu .xu, projekty xuda-cli ju deklarujú namiesto toho ako súbor .route.json5. Jej prívetivý kľúč prog sa v dokumente Studia skompiluje na routeMenu.menu[].prog_id.