Διαδρομή
Ένα σημείο εισόδου πλοήγησης, ένα μενού προορισμών, καθένας από τους οποίους δείχνει στο component που παρέχει το περιεχόμενό του.
Μια Διαδρομή (Route) ορίζει μια επιφάνεια πλοήγησης μιας εφαρμογής Xuda: ένα μενού προορισμών, καθένας από τους οποίους είναι μια διαδρομή ή μια ετικέτα που αντιστοιχίζεται στο Component που την αποδίδει. Οι Διαδρομές ζουν στον δικό τους κλάδο του δέντρου του Studio, χωριστά από τα Προγράμματα και τη Βάση δεδομένων, και μία εφαρμογή μπορεί να δηλώσει πολλές, έναν δημόσιο ιστότοπο, έναν πίνακα διαχείρισης, ένα κέλυφος για κινητά, καθεμία ως δικό της έγγραφο Διαδρομής.
Ιδιότητες
Το studio_meta.parentId έχει προεπιλογή routes, τη ρίζα του δέντρου Διαδρομών. Σε αντίθεση με τα Προγράμματα και τη Βάση δεδομένων, το δέντρο Διαδρομών δεν έχει φωλιασμένους φακέλους, κάθε Διαδρομή βρίσκεται απευθείας κάτω από αυτή τη ρίζα.
Η λίστα επιτρεπόμενων του ελέγχου για το properties.menuType (CHK_MSG_OBJ_GEN_105) παραλείπει το route, επομένως κάθε έγγραφο Διαδρομής εμφανίζει "invalid properties.menuType" στη λίστα προβλημάτων, ακόμη κι αν το check_route τρέχει τους δικούς του, πραγματικούς ελέγχους (CHK_MSG_RTE_MNU_010/020/030) ακριβώς δίπλα του. Δεν εμποδίζει την αποθήκευση ή την ανάπτυξη μιας διαδρομής, είναι θόρυβος που πρέπει να περιμένετε και να αγνοείτε στην έξοδο του ελέγχου, όχι ένδειξη ότι η διαδρομή έχει λάθος ρυθμίσεις.
routeMenu
Κάθε καταχώριση στο menu χρειάζεται ένα prog_id που ονομάζει το Component που παρέχει το περιεχόμενό της, αν λείπει, ή αν ονομάζει ένα πρόγραμμα που το έργο δεν έχει, είναι σφάλμα ελέγχου. Τα στοιχεία μπορούν να φωλιάζουν (children), και το καθένα φέρει πεδία εμφάνισης όπως τα bgColor / bgTextColor για την ενεργή κατάστασή του, που συμπληρώνονται από τον επεξεργαστή Διαδρομών.
Παράδειγμα εφαρμογής
Απαριθμήστε τους προορισμούς
Μία καταχώριση μενού ανά οθόνη: ένας τίτλος, και το _id του Component που ανοίγει.
Επιλέξτε μια προεπιλογή
Το default_menu_id ονομάζει την καταχώριση που εμφανίζεται όταν ανοίγει για πρώτη φορά η διαδρομή.
Στρέψτε ένα Component προς αυτήν
Οι περισσότερες εφαρμογές αντικατοπτρίζουν τη διαδρομή και ως κυριολεκτική διεπαφή πλοήγησης (καρτέλες, πλευρική γραμμή), με το xu-on:click κάθε κουμπιού να καλεί το call_page με το αναγνωριστικό του Component-στόχου, ώστε η διαδρομή να παραμένει η πηγή αλήθειας και η διεπαφή να μένει συγχρονισμένη με αυτήν.
Κάτω από τις Διαδρομές στο δέντρο του Studio, προσθέστε μια διαδρομή και μετά φτιάξτε το μενού της στον επεξεργαστή Διαδρομών: προσθέστε ένα στοιχείο, δώστε του μια ετικέτα και επιλέξτε το Component που πρέπει να ανοίγει.
Μια διαδρομή δεν έχει μορφή πηγής .xu, τα έργα xuda-cli τη δηλώνουν ως αρχείο .route.json5. Το φιλικό κλειδί prog της μεταγλωττίζεται στο routeMenu.menu[].prog_id στο έγγραφο του Studio.