Siirry sisältöön
Tarkistettu

Reitti

Navigoitava aloituspiste, kohteiden valikko, jonka jokainen kohde osoittaa komponenttiin, joka tarjoaa sen sisällön.

Reitti määrittelee Xuda-sovelluksen navigoitavan pinnan: kohteiden valikon, jonka jokainen kohde on polku tai nimike, joka on kytketty sen renderöivään Komponenttiin. Reitit asuvat omassa haarassaan Studion puussa, erillään Ohjelmista ja Tietokannasta, ja yksi sovellus voi ilmoittaa useita: julkisen sivuston, ylläpitokojelaudan, mobiilikuoren, kukin oma Reitti-dokumenttinsa.

Ominaisuudet

studio_meta.parentId on oletuksena routes, Reitit-puun juuri. Toisin kuin Ohjelmissa ja Tietokannassa, Reitit-puussa ei ole kansiosisäkkäisyyttä: jokainen Reitti sijaitsee suoraan sen juuren alla.

Jokainen Reitti-dokumentti saa tällä hetkellä virheen linttauksessa

Tarkistimen properties.menuType-sallittujen lista (CHK_MSG_OBJ_GEN_105) jättää pois arvon route, joten jokainen Reitti-dokumentti nostaa ongelmalistaan "invalid properties.menuType", vaikka check_route ajaa omat todelliset tarkistuksensa (CHK_MSG_RTE_MNU_010/020/030) aivan sen rinnalla. Se ei estä reitin tallentamista tai julkaisemista, se on kohinaa, jonka voi odottaa ja ohittaa tarkistimen tulosteessa, ei merkki siitä, että reitti olisi väärin määritetty.

routeMenu

Jokainen menu-merkintä tarvitsee prog_id:n, joka nimeää sen sisällön tarjoavan Komponentin. Sen puuttuminen tai sellaisen ohjelman nimeäminen, jota projektissa ei ole, on tarkistinvirhe. Kohteet voivat olla sisäkkäisiä (children), ja kukin kantaa näyttökenttiä, kuten bgColor / bgTextColor aktiivista tilaansa varten, jotka Reitit-editori täyttää.

Käyttöesimerkki

Listaa kohteet

Yksi valikkomerkintä näkymää kohti: otsikko ja sen avaaman Komponentin _id.

Valitse oletus

default_menu_id nimeää merkinnän, joka näytetään, kun reitti avataan ensimmäisen kerran.

Osoita Komponentti siihen

Useimmat sovellukset peilaavat reitin myös konkreettisena navigointikäyttöliittymänä (välilehdet, sivupalkki), jolloin kunkin painikkeen xu-on:click kutsuu call_page-toimintoa kohdekomponentin tunnuksella. Näin reitti pysyy totuuden lähteenä ja käyttöliittymä pysyy sen mukana.

Studion puussa Reitit-kohdassa lisää reitti ja rakenna sen valikko Reitit-editorissa: lisää kohde, anna sille nimike ja valitse Komponentti, jonka sen pitäisi avata.

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

Reitillä ei ole .xu-lähdemuotoa, xuda-cli-projektit ilmoittavat sen .route.json5-tiedostona. Sen ystävällinen prog-avain käännetään Studio-dokumentissa muotoon routeMenu.menu[].prog_id.

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