נתיב
נקודת כניסה שאפשר לנווט אליה, תפריט של יעדים, שכל אחד מצביע על הרכיב שמספק את התוכן שלו.
נתיב מגדיר משטח ניווט של אפליקציית Xuda: תפריט של יעדים, שכל אחד מהם נתיב או תווית שממופים לרכיב שמציג אותו. נתיבים נמצאים בענף משלהם בעץ של 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 שמציין את הרכיב שמספק את התוכן שלה, חסרון שלו, או ציון תוכנית שאין בפרויקט, הוא שגיאת בודק. פריטים יכולים להיות מקוננים (children), וכל אחד נושא שדות תצוגה כמו bgColor / bgTextColor למצב הפעיל שלו, שעורך הנתיבים ממלא.
דוגמת עבודה
לרשום את היעדים
רשומת תפריט אחת לכל מסך: כותרת, וה-_id של הרכיב שהיא פותחת.
לבחור ברירת מחדל
default_menu_id מציין את הרשומה שמוצגת כשהנתיב נפתח לראשונה.
להפנות רכיב אליו
רוב האפליקציות משקפות את הנתיב גם כממשק ניווט מילולי (לשוניות, סרגל צד), כש-xu-on:click של כל כפתור קורא ל-call_page עם המזהה של רכיב היעד, כך שהנתיב נשאר מקור האמת והממשק נשאר מסונכרן איתו.
תחת נתיבים בעץ של Studio, מוסיפים נתיב, ואז בונים את התפריט שלו בעורך הנתיבים: מוסיפים פריט, נותנים לו תווית, ובוחרים את הרכיב שהוא אמור לפתוח.
לנתיב אין צורת מקור .xu, פרויקטים של xuda-cli מצהירים עליו כקובץ .route.json5 במקום. המפתח הידידותי prog שלו מקומפל ל-routeMenu.menu[].prog_id במסמך Studio.