Przejdź do treści
Wersja robocza

Trasa

[object Object]

Trasa definiuje nawigowalną powierzchnię aplikacji Xuda: menu miejsc docelowych, z których każde to ścieżka lub etykieta przypisana do Component, który ją renderuje. Trasy mieszkają we własnej gałęzi drzewa Studio, oddzielnej od Programów i Bazy danych, a jedna aplikacja może zadeklarować ich kilka: stronę publiczną, panel administratora, powłokę mobilną, każdą jako osobny dokument Trasy.

Właściwości

studio_meta.parentId domyślnie ma wartość routes, czyli korzeń drzewa Tras. W odróżnieniu od Programów i Bazy danych drzewo Tras nie ma zagnieżdżania folderów: każda Trasa leży bezpośrednio pod tym korzeniem.

Każdy dokument Trasy dziś jest zgłaszany jako błąd

Lista dozwolonych properties.menuType w weryfikatorze (CHK_MSG_OBJ_GEN_105) pomija route, więc każdy dokument Trasy zgłasza na liście problemów "invalid properties.menuType", mimo że check_route wykonuje obok własne, prawdziwe sprawdzenia (CHK_MSG_RTE_MNU_010/020/030). Nie blokuje to zapisu ani wdrożenia trasy; to szum, którego należy się spodziewać i który można zignorować w wynikach weryfikatora, a nie znak, że trasa jest źle skonfigurowana.

routeMenu

Każdy wpis w menu potrzebuje prog_id wskazującego Component, który dostarcza jego zawartość; jego brak albo wskazanie programu, którego projekt nie ma, to błąd weryfikatora. Pozycje mogą się zagnieżdżać (children), a każda niesie pola wyświetlania, takie jak bgColor / bgTextColor dla stanu aktywnego, wypełniane przez edytor Tras.

Przykład krok po kroku

Wypisz miejsca docelowe

Jeden wpis menu na ekran: tytuł i _id Component, który otwiera.

Wybierz domyślne

default_menu_id wskazuje wpis pokazywany, gdy trasa jest otwierana po raz pierwszy.

Wskaż Component

Większość aplikacji odzwierciedla trasę także w dosłownym interfejsie nawigacji (karty, panel boczny), a xu-on:click każdego przycisku wywołuje call_page z identyfikatorem docelowego Component, dzięki czemu trasa pozostaje źródłem prawdy, a interfejs jest z nią zsynchronizowany.

W Trasach w drzewie Studio dodaj trasę, a potem zbuduj jej menu w edytorze Tras: dodaj pozycję, nadaj jej etykietę i wybierz Component, który ma otwierać.

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 nie ma formy źródłowej .xu; projekty xuda-cli deklarują ją jako plik .route.json5. Jej przyjazny klucz prog kompiluje się do routeMenu.menu[].prog_id w dokumencie Studio.

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

Powiązane