Xuda Slim
נקודת הכניסה הקלה בדפדפן אל סביבת הריצה של Xuda, בלי צורך בטוען פרויקט.
Xuda Slim הוא משטח הכתיבה וההטמעה הקל של סביבת הריצה של Xuda. הוא שימושי כשרוצים את מקור הנתונים הריאקטיבי, ההוראות, האירועים והתגים המבניים של Xuda, בלי להתחיל ממבנה הפרויקט המלא של Xuda CLI.
Slim הוא עדיין Xuda, לא סביבת ריצה אחרת. ביטויים עדיין קוראים שדות עם @field_name, סביבת הריצה עדיין עובדת ממסמכי תוכנית של Xuda, ותגים מבניים כמו xu-single-view ו-xu-panel עדיין חשובים. <template> נתמך, אבל הוא לא חובה.
למה Slim מיועד
- דפי HTML שנכתבים ביד עם ריאקטיביות של Xuda
- הדגמות של סביבת הריצה ותיעוד
- ווידג'טים או אתרי מיקרו להטמעה
- עצי סביבת ריצה של
project_dataשנוצרים אוטומטית - אימוץ הדרגתי של Xuda בלי להכניס קודם מהדר מקור מלא
שלושת מצבי הכתיבה
אפשר לשלב בין המצבים האלה: אם Slim מקבל project_data ובדף יש גם תגי <template>, התבניות מנותחות ומתווספות אל project_data.programs לצד הנתונים.
טעינת סביבת הריצה
הדרך הנתמכת להשיג את החבילה היא חבילת ה-npm הציבורית @xuda.io/xuda-runtime-slim-es. אם יש לכם אפליקציית Xuda שפרסתם, הפלטפורמה מגישה את חבילת סביבת הריצה גם מדומיין האפליקציה שלכם ב-/cdn, עם גרסה לא מכווצת ב-/cdn/debug.
תג ה-script שלמעלה מצביע על מארח פיתוח, ושימושי לנסות את Slim מקומית. דף שנפרס צריך לטעון את @xuda.io/xuda-runtime-slim-es, או להגיש את החבילה מדומיין האפליקציה שלכם ב-/cdn.
הבנאי
הארגומנטים מותאמים לפי סוג, לא לפי מיקום: אלמנט, אובייקט אפשרויות ופונקציית callback אפשר להעביר בכל סדר.
element: אלמנט ה-DOM לטעון אליו. אופציונלי ב-Slim: משמיטים אותו וסביבת הריצה חוזרת ל-document.bodyורושמת אזהרה במקום להיכשל.options: אפשרויות סשן וסביבת ריצה, שמפורטות להלן.callback: נקראת כ-callback('xuda_ready', SESSION_ID, SESSION_OBJ)ברגע שהאפליקציה מוכנה.
להשלמת הטעינה, הוו האמין ביותר הוא האירוע on_mounted על document.body:
אפשרויות נפוצות
כל אפשרות שלהלן נפתרת דרך אותה שרשרת בת שישה שלבים: קודם פרמטר שאילתה ב-URL, אחר כך מאפיין על אלמנט השורש, אחר כך options.params[key], אחר כך options[key], אחר כך עוגייה, ואחר כך localStorage. לכן אפשר להגדיר מחדש דף Slim ממחרוזת שאילתה בלי שינוי קוד.
איך יודעים ש-Slim עובד
- החבילה נטענה
- ה-
prog_idשלכם מציג משהו גלוי - האירוע
on_mountedמופעל - עדכוני ממשק שמונעים על ידי שדות מתחילים להתנהג באופן ריאקטיבי
אם כל ארבעת אלה קורים, הדף במצב טוב. אם שום דבר לא מוצג, בודקים לפי הסדר: החבילה באמת נטענה, prog_id מתאים למזהה תבנית אמיתי או למפתח תוכנית, התוכנית קיימת ב-project_data.programs, ויעד הטעינה הוא אלמנט אמיתי (או שהושאר בכוונה לחזרה ל-body).