דילוג לתוכן
אומת

הוראות סביבת ריצה

כל אוצר המילים של הוראות xu-* ש-Slim וסביבת הריצה של הפלטפורמה חולקים.

הוראות הן הדרך ש-Slim הופך בה סימון רגיל, או צמתי סביבת ריצה, למשטח ריאקטיבי של Xuda. כל אוצר המילים לכתיבה הוא 19 מאפיינים ועוד שתי משפחות עם סיומת.

מצב ופלט

ביטויים

xu-exp:* מעריכה ביטוי מול ערכי שדות ומחילה את התוצאה על <attr>. היא עובדת גם על מאפייני HTML רגילים וגם על מאפייני xu-*.

html
<div xu-exp:xu-content="'Hello ' + @first_name"></div>
<div xu-exp:class="@is_active ? 'text-green-500' : 'text-gray-500'"></div>
xu-exp:class מחליפה, לא ממזגת

xu-exp:class מחליפה לגמרי את מאפיין ה-class הסטטי ולא ממזגת איתו. אם צריך את שניהם, שמים את המחלקות הסטטיות בתוך הביטוי, או משתמשים ב-xu-class לחלק המותנה ומשאירים את class בשקט.

איטרציה והצגה מותנית

משתמשים ב-xu-show כשהצומת צריך להישאר טעון ופשוט להיעלם מהעין, וב-xu-render כשהוא צריך להיות מוסר מה-DOM החי כשהתנאי שקרי.

אירועים ותהליכי עבודה

xu-on:<event> תמיד מקבלת מערך של אובייקטי מטפל, וכל אחד נושא תהליך עבודה:

html
<button
  xu-on:click='[
    { "handler": "custom", "workflow": [
      { "data": { "action": "update", "name": { "value": "@count_v: @count_v + 1" }, "enabled": true } }
    ] }
  ]'
>
  Increment
</button>

שמונה מאפייני קיצור מתנרמלים לתהליכי xu-on:* מלאים לעדכוני שדות פשוטים, ולכן ערך כמו xu-click="count++" עובד בלי JSON של מטפל: xu-click, xu-dblclick, xu-contextmenu, xu-focus, xu-keyup, xu-change, xu-blur, xu-init.

הוראות מתקדמות

סדר הרצה

מאפיינים רצים בשלבים לכל אלמנט. xu-cdn, xu-style, xu-render, xu-for-key ו-xu-for-val רצים לפני שהצומת נבנה; xu-bind, xu-class, xu-script, xu-ui-plugin ו-xu-ref רצים אחריו. הסדר הזה הוא הסיבה שמשאב xu-cdn כבר זמין ל-xu-script על אותו אלמנט.

שמות שדות שמורים

אסור להשתמש בתשעה שמות כמזהה שדה, כי סביבת הריצה מקצה אותם בזמן איטרציה ופתרון הקשר: _NULL, _THIS, _FOR_KEY, _FOR_VAL, _ROWNO, _ROWID, _ROWDOC, _KEY, _VAL.

כלל מעשי

משתמשים בהוראה הקטנה ביותר שמתאימה לצורך: xu-text או xu-content לפלט פשוט, xu-click לעדכון פשוט, xu-on:* ללוגיקת תהליך מלאה, xu-exp:* למאפיינים מחושבים, ו-xu-for / xu-render / xu-show להתנהגות מבנית.

xu-if ושרשרת האחים לא כאן

xu-if, xu-else-if ו-xu-else שייכות למנגנון ההצגה הריאקטיבי, שנשלח רק בחבילה המלאה של הפלטפורמה. לא ל-Slim ולא לסביבת הריצה המצורפת של ה-CLI אין את המנוע הריאקטיבי, ולכן משתמשים במקום זה ב-xu-render או ב-xu-show עם ביטוי על כל ענף. xu-route ו-xu-prog אינן הוראות בכלל: הן מופיעות בחומרי שיווק אבל אין להן מטפל בשום מקום בסביבת הריצה.