Route
Ein ansteuerbarer Einstiegspunkt, ein Menü von Zielen, jedes verweist auf die Komponente, die seinen Inhalt liefert.
Eine Route definiert eine ansteuerbare Oberfläche einer Xuda-App: ein Menü von Zielen, jedes ein Pfad oder eine Beschriftung, die der Komponente zugeordnet ist, die sie darstellt. Routen liegen in einem eigenen Zweig des Studio-Baums, getrennt von Programmen und Datenbank, und eine einzelne App kann mehrere deklarieren, eine öffentliche Website, ein Admin-Dashboard, eine mobile Hülle, jeweils als eigenes Route-Dokument.
Eigenschaften
studio_meta.parentId ist standardmäßig routes, die Wurzel des Routen-Baums. Anders als bei Programmen und Datenbank gibt es im Routen-Baum keine Ordnerverschachtelung, jede Route liegt direkt unter dieser Wurzel.
Die Allowlist properties.menuType des Prüfers (CHK_MSG_OBJ_GEN_105) lässt route aus, deshalb löst jedes Route-Dokument in der Problemliste "invalid properties.menuType" aus, obwohl check_route direkt daneben seine eigenen, echten Prüfungen ausführt (CHK_MSG_RTE_MNU_010/020/030). Es blockiert das Speichern oder Bereitstellen einer Route nicht, es ist Rauschen, das du in der Prüfer-Ausgabe erwarten und ignorieren kannst, kein Zeichen dafür, dass die Route falsch konfiguriert ist.
routeMenu
Jeder Eintrag in menu braucht eine prog_id, die die Komponente nennt, die seinen Inhalt liefert; fehlt sie oder nennt sie ein Programm, das das Projekt nicht hat, ist das ein Prüferfehler. Einträge können verschachtelt sein (children), und jeder trägt Anzeigefelder wie bgColor / bgTextColor für seinen aktiven Zustand, die der Routen-Editor ausfüllt.
Praxisbeispiel
Die Ziele auflisten
Ein Menüeintrag pro Bildschirm: ein Titel und die _id der Komponente, die er öffnet.
Einen Standard wählen
default_menu_id nennt den Eintrag, der beim ersten Öffnen der Route angezeigt wird.
Eine Komponente darauf richten
Die meisten Apps bilden die Route zusätzlich als wörtliche Navigations-UI ab (Tabs, eine Seitenleiste), wobei das xu-on:click jeder Schaltfläche call_page mit der ID der Zielkomponente aufruft, sodass die Route die maßgebliche Quelle bleibt und die UI mit ihr synchron bleibt.
Füge unter Routen im Studio-Baum eine Route hinzu und baue dann ihr Menü im Routen-Editor: Füge einen Eintrag hinzu, gib ihm eine Beschriftung und wähle die Komponente, die er öffnen soll.
Eine Route hat keine .xu-Quellform, xuda-cli-Projekte deklarieren sie stattdessen als Datei .route.json5. Ihr einfacher Schlüssel prog wird im Studio-Dokument zu routeMenu.menu[].prog_id kompiliert.