Trasa
Navigovatelný vstupní bod, nabídka cílů, z nichž každý ukazuje na komponentu, která poskytuje jeho obsah.
Trasa (Route) definuje navigovatelnou plochu aplikace Xuda: nabídku cílů, z nichž každý je cesta nebo popisek přiřazený Komponentě, která ho vykresluje. Trasy žijí ve vlastní větvi stromu Studia, odděleně od Programů a Databáze, a jedna aplikace jich může deklarovat několik: veřejný web, administrační dashboard, mobilní obal, každý jako vlastní dokument Trasy.
Vlastnosti
studio_meta.parentId je ve výchozím stavu routes, kořen stromu Tras. Na rozdíl od Programů a Databáze nemá strom Tras vnořování složek, každá Trasa leží přímo pod tímto kořenem.
Povolený seznam properties.menuType v kontrole (CHK_MSG_OBJ_GEN_105) vynechává route, takže každý dokument Trasy vyvolá v seznamu problémů "invalid properties.menuType", přestože check_route hned vedle provádí vlastní, skutečné kontroly (CHK_MSG_RTE_MNU_010/020/030). Neblokuje to uložení ani nasazení trasy, je to šum, který ve výstupu kontroly očekávejte a ignorujte, ne znamení, že je trasa špatně nastavená.
routeMenu
Každý záznam v menu potřebuje prog_id s názvem Komponenty, která poskytuje jeho obsah, jeho chybějící hodnota, nebo název programu, který projekt nemá, je chyba kontroly. Položky se mohou vnořovat (children) a každá nese zobrazovací pole jako bgColor / bgTextColor pro svůj aktivní stav, vyplněná editorem Tras.
Pracovní příklad
Vypište cíle
Jedna položka nabídky na obrazovku: nadpis a _id Komponenty, kterou otevírá.
Vyberte výchozí
default_menu_id pojmenovává položku zobrazenou při prvním otevření trasy.
Namiřte na ni Komponentu
Většina aplikací trasu zrcadlí i jako doslovné navigační UI (karty, boční panel), kde xu-on:click každého tlačítka volá call_page s id cílové Komponenty, takže trasa zůstává zdrojem pravdy a UI s ní zůstává v souladu.
Pod Trasami ve stromu Studia přidejte trasu a pak vytvořte její nabídku v editoru Tras: přidejte položku, dejte jí popisek a vyberte Komponentu, kterou má otevřít.
Trasa nemá zdrojovou podobu .xu, projekty xuda-cli ji deklarují jako soubor .route.json5. Její přívětivý klíč prog se v dokumentu Studia zkompiluje na routeMenu.menu[].prog_id.