ספר ההדרכה / רכיבים

רכיבים

רכיבים נגררים מהפאנל הצדדי אל תוך מסגרת הטלפון בעורך. לכל רכיב יש שם קריא ומזהה קבוע (למשל btn_1, img_2) ומספר סידורי - ה-אינדקס - שמוצג כ-"#N" בפאנל המאפיינים. את האינדקס אפשר להזכיר בפעולת "הרצת קוד" כ-element[N], כדי לקרוא או לכתוב ישירות לרכיב הזה במסך הנוכחי.

קטגוריות הרכיבים

קטגוריה רכיבים
טקסט ותוכן כותרת · טקסט · כרטיס · רשימה · תגית · תגיות/צ׳יפים · רשימה מתקפלת (accordion)
מדיה תמונה · וידאו · נגן אודיו · קרוסלת תמונות · תמונת פרופיל · אייקון
קלט ואינטראקציה שדה קלט · כפתור · מתג הפעלה · דירוג כוכבים
מבנה ופריסה מכולה (container) · פריסה (חלוקת שורה מהירה - חצי/שליש/רבע) · קו מפריד · רווח · לופ דטה
נתונים חיים וסטטוס פס התקדמות · טבעת התקדמות · מונה סטטיסטי · טיימר ספירה לאחור · יומן · באנר התראה
משחק וציור בורר צבע · צורה (מלבן/עיגול/משולש) · קנבס ציור (ציור חופשי עם פעולות צבע/עובי מברשת/ניקוי)
קישורים קישורי רשתות חברתיות (וואטסאפ, אינסטגרם, פייסבוק, טיקטוק, אימייל, טלפון)

מכולה (Container) מול לופ דטה (Data Loop)

אלה שני "רכיבי המכולה" היחידים שיכולים להכיל רכיבים בתוכם:

  • מכולה (container) - יכולה להכיל כל מספר רכיבי-ילד, ומאפשרת לפרוס אותם בעמודה, בשורה, או בשורה שנשברת (row-wrap).
  • לופ דטה (dataLoop) - קורא שורות מטבלת נתונים בשרת (sdb.<table>) ומשכפל את תבנית הילד שלו פעם אחת לכל שורה. מותר לו רק ילד אחד - אם רוצים כמה רכיבים בכל שורה (למשל תמונה + טקסט + כפתור), צריך לעטוף אותם קודם ב-container אחד ולשים את ה-container בתוך הלופ.

בתוך תבנית השורה מתייחסים לעמודות של אותה שורה כ-{{row.columnName}}. שדות הלופ עצמו: collection (שם הטבלה), sortBy/sortDir (מיון עולה/יורד), limit, ופילטר שורה אופציונלי filterField / == / != / filterValue - וכל השדות האלה יכולים לקבל גם {{משתנה}} במקום ערך קבוע. פירוט מלא על הטבלה עצמה נמצא בפרק "טבלאות נתונים".

הצגה/הסתרה ואנימציית כניסה

  • מוסתר בהתחלה - סימון על רכיב שגורם לו לא להיות מוצג כלל כשהאפליקציה נטענת, עד שאוטומציה עם פעולת "הצגת אלמנט" תחשוף אותו. שימושי לתפריטים, פרסים מוסתרים, תוצאות משחק וכו׳.
  • אנימציית כניסה - none / fadeIn / slideUp / slideIn / zoomIn / bounceIn / flipIn, מופעלת פעם אחת כשהרכיב נכנס לתצוגה. אוטומציה יכולה להפעיל אותה שוב לפי דרישה עם פעולת "הפעלה חוזרת של אנימציית כניסה".
  • אנימציה רציפה - none / pulse / bounce / float / spin, רצה כל עוד הרכיב קיים (לא רק פעם אחת) - רמז "שימו לב כאן" בלי צורך באוטומציה. אם גם זו וגם אנימציית כניסה מוגדרות, אנימציית הכניסה רצה קודם והרציפה מתחילה כשהיא מסתיימת. אוטומציה יכולה להתחיל, להחליף, או לעצור אותה בזמן ריצה עם פעולת "הגדרת אנימציה רציפה".
שימו לב

רכיב שסומן "מוסתר בהתחלה" ולא קישרתם אליו אף אוטומציה עם פעולת "הצגת אלמנט" - יישאר מוסתר לצמיתות. תמיד לוודא שיש נתיב שחושף אותו (פירוט בפרק "טעויות נפוצות").

שדה קלט (input) - סוגי שדה

ל-input יש רשימת fieldType שממופה ישירות לסוג שדה ב-HTML: טקסט קצר, סיסמה, טקסט ארוך (textarea), מספר, תאריך, תאריך+שעה, שעה, מספר טלפון, אימייל, אתר אינטרנט (URL). שם השדה (fieldName) הוא מה שיאפשר לקרוא את הערך שהמבקר הקליד בתור משתנה רגיל (למשל שדה בשם email נגיש כ-{{email}} מיד אחרי אירוע לחיצה על כפתור השליחה שבאותו טופס).