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