שפת .xu
פורמט הבלוקים שבו כתוב כל קובץ מקור `.xu`, ואחד עשר אבני הבניין שפרויקט עשוי מהן.
קובץ .xu הוא קובץ בלוקים, לא מודול JavaScript. כל בלוק הוא עניין אחד, ובלוקי האובייקטים (<meta>, <params>, <fields>, <actions>, <events>, <datasource>) מנותחים כליטרלים בסגנון JSON5: מפתחות בלי מרכאות, מערכים ואובייקטים מקוננים כולם תקינים.
אחד עשר אבני בניין
התיקייה שבה נמצא קובץ מקור קובעת לאיזה סוג יחידה הוא מתקמפל. אפליקציית Xu טובה נקראת בדרך כלל ברור יותר כשלכל עניין יש יחידה משלו, במקום קובץ אחד שעושה הכול.
App.xu הוא הקובץ השמור היחיד: הוא תמיד האפליקציה הראשית ותמיד מתקמפל למזהה התוכנית app. בקובץ component המזהה נקבע לפי הסדר מ-meta.id, אחר כך מ-mount.id, ואז משם הבסיס של הקובץ עצמו. לכל סוג יחידה אחר אין בלוק <mount>, ולכן המזהה שלו נקבע מ-meta.id, ואז משם הבסיס של הקובץ עצמו. במשאבי ה-JSON5 הסדר הוא id, אחר כך _id, ואז שם הבסיס. מזהים כפולים בפרויקט אסורים.
בלוקים לפי סוג יחידה
App.xu אף פעם לא צריך בלוק <mount>. רכיב רגיל צריך אותו רק כשרוצים שהוא ייטען ישירות לתוך דף HTML ולא יושג דרך <panel program="...">:
שפת התבניות
בתוך <template>, קבוצה קטנה של כינויים ידידותיים מתקמפלת לסימון ה-xu-* של סביבת הריצה עצמה.
רכיב, מההתחלה ועד הסוף
<script> מתקמפל למודול טעינה בצד הלקוח: ייצוא ברירת המחדל מקבל אובייקט הקשר ויכול להחזיר פונקציית ניקוי שתרוץ בעת הפריקה. בלוקי <style> נאספים לגיליון סגנונות אחד של הרכיב שמוגש.
פורמט מקור הנתונים
משתמשים בצורת העטיפה הקריאה בתוך <datasource lang="json5">. type הוא אחד מ-none, table, array, json או csv.
מקור נתונים של טבלה משתמש ב-table, filter, sort, direction, realtime, limit, skip ו-output. מקור נתונים של מערך, JSON או CSV משתמש ב-source.field או ב-source.url. לכל מפתח של מקור נתונים שצורת העטיפה לא חושפת, עוברים ל-mode="raw" וכותבים את שמות השדות שמסמך סביבת הריצה עצמו משתמש בהם.
עשרת הבלוקים האחרים, בקצרה
קריאות עם שם, לשימוש חוזר. data/get/LoadStudentClasses.xu מצמיד את <params> (שדות in/out מוצהרים) ל-<datasource>, כך שרכיב קורא לטוען בשמו במקום להחזיק בעצמו את פרטי השאילתה.
כתיבות עם שם. data/set/SaveStudentProfile.xu מוסיף crudMode ו-allowCreate ל-<meta> לצד הפרמטרים ומקור הנתונים, ונותן לשמירה בית גלוי ובר בדיקה במקור.
עיבוד רשומה אחר רשומה. data/batch/RebuildClassRoster.xu מריץ שלב של <events> כמו before_record על כל שורה ש-<datasource> מחזיר.
בלוק <response> הופך פרמטרים, תוצאות של מקור נתונים ואירועים למטען בסגנון JSON:
המרה עם שם, לשימוש חוזר. <code> רץ כגוף פונקציה על פרמטרי ה-in המוצהרים ומחזיר את ערך ה-out:
הגדרת הודעה לשימוש חוזר, שאליה מפנים מתהליך עבודה במקום לכתוב אותה בתוך השורה בכל פעם:
נתיבים מתארים איך רכיבים מוצגים כאפליקציה שאפשר לנווט בה; הם לא מחליפים את הרכיבים עצמם.
דוגמה מלאה
xuda-studant-app-example הוא עץ מקור שלם שמכסה את כל אחד עשר הבלוקים: זרימת התחברות, לוח בקרה עם ניתוב, רשימת תלמידים, משימות ומסכי פרופיל, קריאות וכתיבות שמבוססות על טבלאות, ועיצוב Tailwind. פורקים אותו עם:
כל מה שלמעלה הוא הדיאלקט המפורש ש-xuda-cli מקמפל: בלוקים שמנותחים בזמן שמירה למסמכי סביבת ריצה progUi / progFields / progEvents, שנקראים על ידי מנגנון ההצגה של הפלטפורמה שמונע ביטויים. מהדר נפרד שלא פורסם (@xuda/compiler, שבו משתמש vite-plugin-xu) קורא קובץ .xu צר יותר שעשוי רק מ-<template>, <script> ו-<style>, מתעלם משמות הבלוקים שלמעלה, ופולט מראש מודול ES אמיתי במקום מסמך JSON. הוא מכוון למנגנון ההצגה החדש יותר שמבוסס על signals ב-@xuda/core, אותו מנוע שהפלטפורמה משלבת כ-runtime/js/xuda_core.globals.js. ראו vite-plugin-xu ו-@xuda/core לנתיב הזה.