רכיב
יחידת הממשק, עץ אלמנטים שקשור למצב מקומי, לנתונים וללוגיקת תהליך העבודה שמחברת ביניהם.
רכיב הוא יחידת ממשק: עץ אלמנטים שקשור למצב מקומי, לנתונים אופציונליים, ללוגיקת מחזור חיים ולממשק קלט ופלט. דף, כרטיס, חלון מודאלי, פופאובר, קטע מוטבע, כולם רכיבים, וזה סוג המסמך העשיר ביותר בפלטפורמה, שנושא עץ ממשק משלו לצד השדות, האירועים ומקור הנתונים שמשותפים לכל סוג תוכנית אחר.
מאפיינים
renderType (form / grid / list) הוצא משימוש ואינו נדרש עוד; רכיבים חדשים נוצרים בלעדיו. מה שרכיב חדש מקבל בפועל הוא בחירת שלד, single או multi, שנבחרת פעם אחת בחלון רכיב חדש: single מזריע שורש xu-template חשוף שמוכן לבנייה ישירה בתוכו, multi מזריע את אותו שורש xu-template עם div של טעינה ו-xu-multi-view שכבר מקוננים בתוכו. xu-single-view עדיין תגית אמיתית שאפשר לכתוב, רק לא כזו שהמפעל מציב בשבילכם: רק מסמך ישן שלא הועבר (השורש עדיין לא xu-template) נבדק מולה, כש-renderType הישן שלו עדיין אומר form.
progUi, עץ האלמנטים
צומת השורש הוא תמיד xu-template שקוף, שמוזרע על ידי scaffold_prog_ui של create_prog. בחירה בשלד multi מקננת בתוכו בשבילכם div של טעינה ו-xu-multi-view; שלד single משאיר אותו ריק, ובונים ישירות בתוך ה-children שלו. כל צומת צריך id ייחודי, type: "element", tagName, וגם attributes: {} ו-children: [] גם כשהם ריקים.
מלבד תגיות HTML רגילות, מספר תגיות של xuda נכתבות ישירות: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.
tagName שמתחיל באות גדולה (Button, Dialog) נתפס תמיד כרכיב מקומפל של מערכת עיצוב, לעולם לא כאלמנט HTML, גם כשזו שגיאת הקלדה: הוא זורק שגיאה בעת ההרכבה, ושם את התגית ואת כל מקור שנוסה. המאפיינים הפשוטים שלו הופכים ל-props, לא למאפייני DOM (variant, color, class מגיעים כולם כ-props.<name>), ובניגוד ל-xu-panel אין לו פרמטרי פלט, תגית רכיב רק קוראת את מה שמעבירים לה.
התנהגות דינמית: מאפייני xu-*
כל מאפיין xu-* שעץ האלמנטים של רכיב יכול לשאת:
קל להתבלבל בשניים מהם: xu-bind מקבל את מזהה השדה החשוף, בלי @, היוצא מן הכלל היחיד לכלל ה-@ בכל מקום אחר; ו-xu-exp:class מחליף את מאפיין ה-class הסטטי לגמרי, ולכן צריך לחזור על מחלקות הפריסה בתוך הביטוי.
progFields, progEvents, progDataSource
מצב מקומי (progFields, מסוג virtual או קשור ל-table), מקור נתונים מוטמע אופציונלי, ואירועי מחזור חיים. שלושה מהאירועים האלה מחלקים את העבודה בצורה שקל להתבלבל בה:
הכנסת עבודת רענון ל-screen_ready מריצה מחדש לוגיקת יצירה על DOM שעדיין קיים, ומערימה ווידג'ט שני על הראשון.
הטמעת תוכנית אחרת: xu-panel
xu-panel (tagName באותיות קטנות, מאפיין program) מרכיב תוכנית רכיב אחרת עם שדות, מקור נתונים ואירועים משלה, בניגוד לתגית מערכת עיצוב שמתחילה באות גדולה. מעבירים ערכים לפרמטרי ה-_in שלה עם מאפייני xu-exp:<param>; בניגוד לתגית מערכת עיצוב, פאנל יכול לכתוב ערכים בחזרה לשדות שלכם דרך פרמטרי ה-_out שלו.
דוגמת עבודה
לבחור את הצורה
בוחרים single בחלון רכיב חדש לרשומה אחת: בונים ישירות בתוך שורש xu-template. בוחרים multi לרשימה: הוא מזריע בשבילכם xu-multi-view בתוך השורש הזה, ומוסיפים xu-for (או את הקיצור for= של .xu) על הצומת החוזר.
לקשור את הנתונים
xu-bind לשדות קלט, xu-exp:xu-content לטקסט מחושב, progDataSource אם הרכיב מחזיק קריאה משלו.
לחבר את האינטראקציה
xu-on:click עם תהליך עבודה, או ב-.xu, בלוק פעולה בשם שמפנים אליו עם @click.
בונים את העץ על הקנבס: גוררים אלמנטים, מגדירים מאפיינים בפאנל המאפיינים, ומחברים מטפלי xu-on:* לצעדי תהליך עבודה בעורך תהליכי העבודה. לוחצים על כפתור ה-play של התצוגה המקדימה כדי לבדוק את התוצאה בשידור חי.
.xu מהדר את <single-view> ל-xu-single-view, את :content לביטוי xu-exp:xu-content, ומאפיין for="@list_v" חשוף ל-xu-for.