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