Sari la conținut
Verificat

Rută

Un punct de intrare navigabil, un meniu de destinații, fiecare indicând componenta care îi oferă conținutul.

O Rută definește o suprafață navigabilă a unei aplicații Xuda: un meniu de destinații, fiecare fiind o cale sau o etichetă asociată componentei care o afișează. Rutele trăiesc într-o ramură proprie a arborelui Studio, separată de Programe și Bază de date, iar o singură aplicație poate declara mai multe: un site public, un dashboard de administrare, o interfață mobilă, fiecare cu propriul document Rută.

Proprietăți

studio_meta.parentId este implicit routes, rădăcina arborelui Rute. Spre deosebire de Programe și Bază de date, arborele Rute nu are foldere imbricate, fiecare Rută se află direct sub acea rădăcină.

Fiecare document Rută dă azi o eroare de lint

Lista de valori permise properties.menuType a verificatorului (CHK_MSG_OBJ_GEN_105) omite route, așa că fiecare document Rută ridică „invalid properties.menuType" în lista de probleme, chiar dacă check_route își rulează propriile verificări reale (CHK_MSG_RTE_MNU_010/020/030) chiar lângă ea. Nu blochează salvarea sau publicarea unei rute, este zgomot la care te poți aștepta și pe care îl poți ignora în rezultatele verificatorului, nu un semn că ruta este configurată greșit.

routeMenu

Fiecare intrare din menu are nevoie de un prog_id care numește componenta ce îi oferă conținutul; dacă lipsește sau numește un program pe care proiectul nu-l are, este o eroare de verificator. Elementele pot fi imbricate (children), iar fiecare poartă câmpuri de afișare precum bgColor / bgTextColor pentru starea activă, completate de editorul de Rute.

Exemplu lucrat

Listează destinațiile

O intrare de meniu pentru fiecare ecran: un titlu și _id-ul componentei pe care o deschide.

Alege una implicită

default_menu_id numește intrarea afișată când ruta este deschisă prima dată.

Îndreaptă o componentă spre ea

Majoritatea aplicațiilor oglindesc ruta și ca interfață de navigare propriu-zisă (file, o bară laterală), fiecare xu-on:click al unui buton apelând call_page cu id-ul componentei țintă, astfel ruta rămâne sursa de adevăr, iar interfața rămâne sincronizată cu ea.

Sub Rute în arborele Studio, adaugă o rută, apoi construiește-i meniul în editorul de Rute: adaugă un element, dă-i o etichetă și alege componenta pe care trebuie s-o deschidă.

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

O rută nu are o formă sursă .xu, proiectele xuda-cli o declară în schimb ca fișier .route.json5. Cheia ei prietenoasă prog se compilează în routeMenu.menu[].prog_id în documentul 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" }
    ]
  }
}