Route
Een navigeerbaar ingangspunt, een menu met bestemmingen die elk wijzen naar de Component die hun inhoud levert.
Een Route definieert een navigeerbaar oppervlak van een Xuda-app: een menu met bestemmingen, elk een pad of een label dat is gekoppeld aan de Component die het toont. Routes staan in hun eigen tak van de Studio-boom, los van Programma's en Database, en één app kan er meerdere declareren, een openbare site, een beheerdashboard, een mobiele shell, elk een eigen Route-document.
Eigenschappen
studio_meta.parentId staat standaard op routes, de wortel van de Routes-boom. Anders dan Programma's en Database heeft de Routes-boom geen mappenstructuur: elke Route staat direct onder die wortel.
De toegestane lijst voor properties.menuType van de checker (CHK_MSG_OBJ_GEN_105) laat route weg, dus elk Route-document geeft "invalid properties.menuType" in de probleemlijst, ook al voert check_route er zijn eigen, echte controles (CHK_MSG_RTE_MNU_010/020/030) direct naast uit. Het blokkeert het opslaan of deployen van een route niet, het is ruis die je mag verwachten en negeren in de checkeruitvoer, geen teken dat de route verkeerd is ingesteld.
routeMenu
Elke vermelding in menu heeft een prog_id nodig die de Component noemt die zijn inhoud levert; als die ontbreekt, of een programma noemt dat het project niet heeft, is dat een checkerfout. Items kunnen nesten (children), en elk heeft weergavevelden zoals bgColor / bgTextColor voor zijn actieve staat, ingevuld door de Routes-editor.
Uitgewerkt voorbeeld
Som de bestemmingen op
Eén menuvermelding per scherm: een titel, en de _id van de Component die het opent.
Kies een standaard
default_menu_id noemt de vermelding die wordt getoond als de route voor het eerst opent.
Wijs een Component ernaar
De meeste apps spiegelen de route ook als letterlijke navigatie-UI (tabbladen, een zijbalk), waarbij de xu-on:click van elke knop call_page aanroept met de id van de doelcomponent, zodat de route de bron van de waarheid blijft en de UI ermee in sync blijft.
Voeg onder Routes in de Studio-boom een route toe en bouw dan zijn menu in de Routes-editor: voeg een item toe, geef het een label en kies de Component die het moet openen.
Een route heeft geen bronvorm in .xu, xuda-cli-projecten declareren hem in plaats daarvan als een bestand .route.json5. Zijn vriendelijke sleutel prog compileert naar routeMenu.menu[].prog_id in het Studio-document.