קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
תוסף שמבוסס על כרטיסים מופיע כחלונית בסרגל הצד (או בנייד, כחלון פעילות נוסף שאפשר להגיע אליו דרך התפריט). לתוסף יש סרגל כלים בחלק העליון שמזהה אותו ומציג כרטיס – למעשה, 'דף' בממשק המשתמש של התוסף. ב-Apps Script, הכרטיסים מיוצגים בקוד הפרויקט באמצעות אובייקטים מסוג Card.
האנטומיה של הכרטיס
כרטיס הוא קבוצה של רכיבי ממשק משתמש שאתם מעצבים. הכרטיס מורכב מהקטעים הבאים:
כותרת כרטיס. זהו המזהה של הכרטיסים. יש לו טקסט של כותרת, ויכול להיות שיש לו גם כותרת משנה וסמל.
קטע אחד או יותר של קלפים. אלה חלוקות משנה של אזור ממשק המשתמש של הכרטיס.
אפשר להוסיף כותרת טקסט לקטע.
קטעי הכרטיס מופרדים זה מזה על ידי קו אופקי.
אם קטע בכרטיס גדול במיוחד, הוא יומר באופן אוטומטי לקטע שניתן לכווץ, והמשתמשים יוכלו להרחיב או לכווץ אותו לפי הצורך.
לכל כרטיס יכולים להיות עד 100 קטעי כרטיסים, ורצוי לכלול רק כמה קטעים כדי לשפר את הביצועים.
כל קטע בכרטיס מכיל ווידג'טים אחד או יותר של ממשק המשתמש. ווידג'טים מספקים למשתמש מידע או פקדים אינטראקטיביים. כרטיסים וקטע כרטיסים הם ווידג'טים מבניים, ולכן אי אפשר להוסיף אותם לקטע כרטיסים. בקטע כרטיסים יכולים להופיע עד 100 ווידג'טים, והוא צריך להיות פשוט ככל האפשר כדי לשפר את הביצועים.
כדאי לעצב כרטיסים שמתמקדים בפעילויות ספציפיות של משתמשים או בקבוצות נתונים ספציפיות. לדוגמה, לתוסף של Google Workspace שמוצגים בו נתונים מ-Google Sheets יכול להיות כרטיס נפרד לכל גיליון שממנו הוא שולף נתונים.
שימוש בכמה כרטיסים
תוספים בדרך כלל מורכבים מכמה כרטיסים. אפשר להגדיר את הקלפים האלה כרשימה פשוטה לניווט בסיסי עם כמה קלפים, או להגדיר שיטות ניווט מורכבות יותר כדי לקבוע איך המשתמש יתקדם בין הקלפים.
אם בתוסף נעשה שימוש בניווט בסיסי, בפעם הראשונה שיפתחו אותו, אפליקציית Google Workspace שהתוסף מרחיב אותה תיצור רשימה של כותרות הכרטיסים ותציג אותן למשתמש. לחיצה על הכותרת של הכרטיס פותחת אותו. יש גם חץ חזרה כדי לחזור לרשימת הכותרות של הכרטיסים. אין צורך לכתוב קוד לפונקציונליות של הכותרת והחץ לאחור – הפעולה הזו מתבצעת באופן אוטומטי כשמגדירים את הכרטיסים בתוסף.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-02-16 (שעון UTC)."],[[["Google Workspace add-ons utilize cards, essentially UI pages, displayed in a sidebar or activity window, to present information and interactive elements."],["Each card is structured with a header, sections containing widgets (like buttons or text fields), and is designed around specific user tasks or data sets."],["Add-ons often employ multiple cards for navigation; basic navigation provides an automatic card header list and back arrow functionality."],["For optimal performance and user experience, it's recommended to keep the number of cards, sections, and widgets to a minimum, prioritizing simplicity in card design."],["Cards have technical limitations, restricting them to a maximum of 100 card sections and 100 widgets per section to maintain performance."]]],["Add-on cards, displayed in a sidebar or activity window, are UI pages built with `Card` objects. Cards have a header, optional subtitle/icon, and sections. Sections, separated by horizontal rules, contain UI widgets, and large sections collapse. Add-ons use multiple cards for navigation, presented as a list of headers. Basic navigation provides automatic back arrow functionality. Each card section can hold a maximum of 100 widgets, and a card can hold no more than 100 card sections.\n"]]
