בווידג'ט Columns מוצגות עד 2 עמודות בכרטיס או בתיבת דו-שיח. אפשר להוסיף ווידג'טים לכל Column. הווידג'טים יופיעו לפי הסדר שבו הם צוינו. דוגמה לשימוש בעמודות באפליקציות של Google Chat מופיעה במאמר עמודות.
הגובה של כל עמודה נקבע לפי העמודה הגבוהה יותר. לדוגמה, אם העמודה הראשונה גבוהה מהעמודה השנייה, הגובה של שתי העמודות יהיה כגובה העמודה הראשונה. כל עמודה יכולה להכיל מספר שונה של ווידג'טים, ולכן אי אפשר להגדיר שורות או ליישר ווידג'טים בין העמודות.
העמודות מוצגות זו לצד זו. אפשר להתאים אישית את הרוחב של כל עמודה באמצעות השדה Horizontal. אם רוחב המסך של המשתמש צר מדי, העמודה השנייה תופיע מתחת לעמודה הראשונה:
- באינטרנט, העמודה השנייה עוברת לשורה חדשה אם רוחב המסך קטן מ-480 פיקסלים או שווה לו.
- במכשירי iOS, העמודה השנייה עוברת לשורה חדשה אם רוחב המסך קטן מ-300 נקודות או שווה לו. pt.
- במכשירי Android, העמודה השנייה עוברת לשורה חדשה אם רוחב המסך קטן מ-320dp או שווה לו.
זמין לאפליקציות של Google Chat ולתוספים ל-Google Workspace. ממשקי המשתמש של התוספים שתומכים בעמודות כוללים:
- תיבת הדו-שיח שמוצגת כשמשתמשים פותחים את התוסף מטיוטת אימייל.
- תיבת הדו-שיח שמוצגת כשמשתמשים פותחים את התוסף מהתפריט הוספת קובץ מצורף באירוע ביומן Google.
// Build a column that is aligned in the center and fills the space: const column = CardService.newColumn() .setHorizontalSizeStyle( CardService.HorizontalSizeStyle.FILL_AVAILABLE_SPACE) .setHorizontalAlignment(CardService.HorizontalAlignment.CENTER) .setVerticalAlignment(CardService.VerticalAlignment.CENTER); const columns = CardService.newColumns().addColumn(column).setWrapStyle( CardService.WrapStyle.WRAP);
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
add | Columns | הוספה של Column לווידג'ט 'עמודות'. |
add | Widget | הוספה של פעולת האירוע שאפשר לבצע בווידג'ט. |
set | Widget | מגדיר את המזהה הייחודי שהוקצה ומשמש לזיהוי הווידג'ט שצריך לשנות. |
set | Widget | הגדרה של רמת החשיפה של הווידג'ט. |
set | Columns | ההגדרה הזו קובעת את סגנון הגלישה של העמודות, ושולטת באופן שבו העמודה משנה את הגודל שלה בהתאם לרוחב המסך. |
תיעוד מפורט
add Column(column)
הוספה של Column לווידג'ט 'עמודות'. העמודות מוצגות לפי הסדר שבו הן נוספו. אפשר להוסיף עד שתי עמודות.
const columns = CardService.newColumns().addColumn(CardService.newColumn());
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
column | Column | עמודה של ילד או ילדה שרוצים להוסיף לווידג'ט Columns (עמודות). |
חזרה
Columns – האובייקט הזה, לשרשור.
add Event Action(eventAction)
הוספה של פעולת האירוע שאפשר לבצע בווידג'ט.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
event | Event | ה-Event שרוצים להוסיף. |
חזרה
Widget – האובייקט, לשרשור.
set Id(id)
מגדיר את המזהה הייחודי שהוקצה ומשמש לזיהוי הווידג'ט שצריך לשנות. שינוי של ווידג'ט נתמך רק בתוספים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
id | String | המזהה של הווידג'ט, עם מגבלה של 64 תווים ובפורמט `[a-zA-Z0-9-]+`. |
חזרה
Widget – האובייקט הזה, לשרשור.
set Visibility(visibility)
הגדרה של רמת החשיפה של הווידג'ט. ערך ברירת המחדל הוא `VISIBLE`.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
visibility | Visibility | הVisibility של הווידג'ט. |
חזרה
Widget – האובייקט, לשרשור.
set Wrap Style(wrapStyle)
ההגדרה הזו קובעת את סגנון הגלישה של העמודות, ושולטת באופן שבו העמודה משנה את הגודל שלה בהתאם לרוחב המסך.
const columns = CardService.newColumns() .addColumn(CardService.newColumn()) .setWrapStyle(CardService.WrapStyle.WRAP);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
wrap | Wrap | סגנון הגלישה שרוצים להגדיר לעמודות. |
חזרה
Columns – האובייקט הזה, לשרשור.