Zum Inhalt springen
Geprüft

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.

Jedes Route-Dokument wird heute als Fehler gemeldet

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.

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

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.

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