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

כתיבה ב-HTML ב-Slim

כותבים HTML רגיל, מוסיפים הוראות של Xuda, ונותנים ל-Slim להפוך אותו לעץ תוכנית.

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

המודל המנטלי

  • HTML רגיל למבנה
  • שדות של מקור נתונים למצב
  • ביטויי @field_name לקריאה
  • הוראות של Xuda לחיווט ההתנהגות
html
<div xu-store="{'headline':'Hello Xuda'}">
  <input xu-bind="headline" />
  <h1 xu-exp:xu-content="@headline"></h1>
</div>

דף מלא

html
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
  <script>
    document.addEventListener('DOMContentLoaded', () => {
      document.body.addEventListener('on_mounted', () => {
        console.log('HTML Slim page mounted');
      }, { once: true });

      const Xuda = globalThis.xuda?.xuda || globalThis.xuda;
      new Xuda(document.getElementById('app'), { domain: 'xuda.ai', prog_id: 'demo' });
    }, { once: true });
  </script>
</head>
<body>
  <div id="app"></div>

  <template id="demo">
    <div class="p-6" xu-store="{'title':'Hello from Slim HTML'}">
      <h1 xu-exp:xu-content="@title"></h1>
    </div>
  </template>
</body>
</html>

איך <template> הופך לתוכנית

כשהדף מכיל תגי <template>, Slim קורא את כולם, משתמש במאפיין id של התבנית כמזהה התוכנית (או template_<index> כשאין id), מנתח את הסימון ל-progUi, ושומר את התוצאה תחת _session.project_data.programs. כשלא מועבר prog_id, התבנית הראשונה בדף הופכת לתוכנית ההפעלה.

תבניות הן אופציונליות. אם כבר מעבירים project_data, התבניות מרחיבות את הנתונים האלה במקום להחליף אותם.

הוראות HTML נפוצות

המדריך המלא להוראות, כולל ביטויים ואירועים, נמצא בהוראות סביבת ריצה.

ניתוח של ערכי מאפיינים

מאפייני תבנית שנראים כמו JSON, מערך ([...]), אובייקט ({...}) או מחרוזת JSON במרכאות, מנותחים עם JSON.parse. ערך תקין הופך לאובייקט או מערך אמיתי ב-progUi; ערך לא תקין נשאר מחרוזת רגילה. xu-store הוא היוצא מן הכלל: המטפל שלו מנתח עם JSON5, ולכן תחביר בסגנון JSON5 (מפתחות בלי מרכאות, מרכאות בודדות) עדיין עובד שם.

מתי כתיבה ב-HTML מתאימה יותר

משתמשים בה לדפי תיעוד, אתרי מיקרו, דפי נחיתה של מוצרים, ווידג'טים מוטמעים ואבות טיפוס שנכתבים ביד. עוברים לCLI כשהאפליקציה גדלה לכמה תכונות עם ניתוב, כשלוגיקת השמירה צריכה בית ברור יותר, או כשכמה סוגי יחידות כמו get_data, set_data ו-batch צריכים לשבת מחוץ לדף.