Hoppa till innehållet
Verifierad

Rutt

En navigerbar startpunkt, en meny med mål som var och en pekar på den komponent som levererar dess innehåll.

En rutt definierar en navigerbar yta i en Xuda-app: en meny med mål, där varje mål är en sökväg eller en etikett som mappas till den komponent som renderar den. Rutter bor i en egen gren av Studio-trädet, skild från Program och Databas, och en enda app kan deklarera flera: en publik webbplats, en admin-dashboard, ett mobilskal, var och en sitt eget rutt-dokument.

Egenskaper

studio_meta.parentId är som standard routes, roten till Rutter-trädet. Till skillnad från Program och Databas har Rutter-trädet ingen mappnästling, varje rutt ligger direkt under den roten.

Varje rutt-dokument ger ett fel i kontrollen i dag

Kontrollens tillåtelselista för properties.menuType (CHK_MSG_OBJ_GEN_105) utelämnar route, så varje rutt-dokument ger "invalid properties.menuType" i problemlistan trots att check_route kör sina egna, riktiga kontroller (CHK_MSG_RTE_MNU_010/020/030) precis bredvid. Det hindrar inte att en rutt sparas eller distribueras, det är brus att räkna med och ignorera i kontrollens utdata, inte ett tecken på att rutten är felkonfigurerad.

routeMenu

Varje post i menu behöver ett prog_id som namnger den komponent som levererar dess innehåll. Om det saknas, eller om det namnger ett program som projektet inte har, är det ett kontrollfel. Poster kan nästlas (children), och var och en bär visningsfält som bgColor / bgTextColor för sitt aktiva tillstånd, ifyllda av Rutter-editorn.

Genomgånget exempel

Lista målen

En menypost per skärm: en titel och _id för den komponent den öppnar.

Välj en standard

default_menu_id namnger posten som visas när rutten först öppnas.

Peka en komponent på den

De flesta appar speglar rutten som bokstavligt navigeringsgränssnitt också (flikar, ett sidofält), där varje knapps xu-on:click anropar call_page med målkomponentens id, så att rutten förblir sanningskällan och gränssnittet hålls synkat med den.

Under Rutter i Studio-trädet lägger du till en rutt och bygger sedan dess meny i Rutter-editorn: lägg till en post, ge den en etikett och välj komponenten den ska öppna.

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

En rutt har ingen .xu-källform, xuda-cli-projekt deklarerar den som en .route.json5-fil i stället. Dess vänliga prog-nyckel kompileras till routeMenu.menu[].prog_id i Studio-dokumentet.

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