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