Preskočiť na obsah
Overené

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.

Každý dokument Trasy dnes hlási chybu

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

json
{
  "id": "student_app_route",
  "menuTitle": "Student Dashboard Route",
  "menu": [
    { "title": "Login", "prog": "app" },
    { "title": "Students", "prog": "student_classes" },
    { "title": "Tasks", "prog": "student_tasks" }
  ]
}

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.

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" }
    ]
  }
}