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