הדפסת כרטיסים

תוסף מבוסס-כרטיסים מופיע כחלונית בסרגל הצד (או בנייד, כחלון פעילות נוסף שאליו מגיעים דרך התפריט). בתוסף יש סרגל כלים עליון שמזהה את התוסף ומציג כרטיס – בעצם 'דף' בממשק המשתמש של התוסף. ב-Apps Script, כרטיסים מיוצגים בקוד הפרויקט באמצעות אובייקטים מסוג Card.

מבנה הכרטיס

כרטיס תוסף לדוגמה

כרטיס הוא קבוצה של רכיבי ממשק משתמש שאתם מעצבים. כרטיס מורכב מהקטעים הבאים:

  • כותרת של כרטיס. המספר הזה מזהה את הכרטיסים. הוא מכיל טקסט של כותרת, ויכול להכיל גם כותרת משנה וסמל.
  • קטע אחד או יותר של כרטיסים. אלה חלוקות משנה של אזור ממשק המשתמש של הכרטיס. אפשר להוסיף כותרת טקסט לקטע. הקטעים בכרטיס מופרדים זה מזה על ידי קו אופקי. אם קטע כרטיס גדול במיוחד, הוא מוצג באופן אוטומטי כקטע שניתן לכווץ ולהרחיב, כך שהמשתמשים יכולים להרחיב או לכווץ אותו לפי הצורך. כרטיס יכול להכיל עד 100 חלקים, אבל כדי לשפר את הביצועים מומלץ להשתמש רק בכמה חלקים.

  • כל קטע בכרטיס מכיל ווידג'ט אחד או יותר של ממשק המשתמש. ווידג'טים מספקים למשתמש מידע או אמצעי בקרה אינטראקטיביים. כרטיסים וקטעי כרטיסים הם ווידג'טים מבניים, ולכן אי אפשר להוסיף אותם לקטע כרטיס. בקטע של כרטיס אפשר להוסיף עד 100 ווידג'טים, וכדי להשיג את הביצועים הטובים ביותר, מומלץ שהקטע יהיה פשוט ככל האפשר.

מומלץ לעצב את הכרטיסים סביב פעילויות משתמשים או מערכי נתונים ספציפיים. לדוגמה, תוסף ל-Google Workspace שמציג נתונים שנלקחו מ-Google Sheets יכול להציג כרטיס נפרד לכל גיליון שהוא שולף ממנו נתונים.

שימוש בכמה כרטיסים

כרטיס תוסף לדוגמה

תוספים בדרך כלל מורכבים מכמה כרטיסים. אפשר להגדיר את הכרטיסים האלה כרשימה פשוטה לניווט בסיסי עם כמה כרטיסים, או להגדיר שיטות ניווט מורכבות יותר כדי לשלוט באופן שבו המשתמש עובר בין הכרטיסים.

אם התוסף משתמש בניווט בסיסי, כשפותחים את התוסף בפעם הראשונה, אפליקציית Google Workspace שהוא מרחיב יוצרת רשימה של כותרות הכרטיסים ומציגה אותה למשתמש. לחיצה על הכותרת של הכרטיס פותחת את הכרטיס. יש גם חץ לחזרה לרשימת הכותרות של הכרטיסים. לא צריך לכתוב קוד כדי להגדיר את הפונקציונליות של הכותרת והחץ 'חזרה'. הפעולות האלה מתבצעות באופן אוטומטי כשמגדירים את הכרטיסים בתוסף.

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