Přeskočit na obsah
Ověřeno

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.

Každý dokument Trasy dnes hlásí chybu

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.

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

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