Gå til indhold
Bekræftet

Rute

Et indgangspunkt, man kan navigere til, en menu af destinationer, hver med peg på den komponent, der leverer indholdet.

En Rute definerer en flade i en Xuda-app, man kan navigere til: en menu af destinationer, hver især en sti eller en etiket knyttet til den Komponent, der viser den. Ruter bor i deres egen gren af Studio-træet, adskilt fra Programmer og Database, og en enkelt app kan erklære flere, et offentligt site, et admin-dashboard, et mobilskal, hver sit Rute-dokument.

Egenskaber

studio_meta.parentId er som standard routes, roden til Rute-træet. I modsætning til Programmer og Database har Rute-træet ingen mappeindlejring, hver Rute ligger direkte under den rod.

Hvert Rute-dokument giver en fejl i lint i dag

Kontrollens tilladelsesliste for properties.menuType (CHK_MSG_OBJ_GEN_105) udelader route, så hvert Rute-dokument rejser "invalid properties.menuType" på problemlisten, selv om check_route kører sine egne, rigtige kontroller (CHK_MSG_RTE_MNU_010/020/030) lige ved siden af. Det forhindrer ikke, at en rute gemmes eller udrulles. Det er støj, du kan forvente og ignorere i kontrollens output, ikke et tegn på, at ruten er forkert sat op.

routeMenu

Hver post i menu skal have et prog_id, der angiver den Komponent, der leverer dens indhold. Hvis det mangler, eller hvis det angiver et program, projektet ikke har, er det en kontrolfejl. Punkter kan indlejres (children), og hvert har visningsfelter som bgColor / bgTextColor til sin aktive tilstand, udfyldt af Rute-editoren.

Eksempel

List destinationerne

Én menupost pr. skærm: en titel og _id for den Komponent, den åbner.

Vælg en standard

default_menu_id angiver den post, der vises, når ruten åbnes første gang.

Peg en Komponent på den

De fleste apps spejler ruten som bogstavelig navigations-UI også (faner, en sidebjælke), hvor hver knaps xu-on:click kalder call_page med målkomponentens id, så ruten forbliver sandhedskilden, og UI'et forbliver i synk med den.

Under Ruter i Studio-træet tilføjer du en rute og bygger derefter dens menu i Rute-editoren: tilføj et punkt, giv det en etiket og vælg den Komponent, det skal åbne.

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 rute har ingen .xu-kildeform, xuda-cli-projekter erklærer den som en .route.json5-fil i stedet. Dens venlige nøgle prog kompileres til 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" }
    ]
  }
}