בווידג'ט Columns מוצגות עד 2 עמודות בכרטיס או בתיבת דו-שיח. אפשר להוסיף ווידג'טים לכל Column. הווידג'טים יופיעו לפי הסדר שבו הם צוינו. דוגמה לאפליקציות ב-Google Chat זמינה במאמר עמודות.
הגובה של כל עמודה נקבע לפי העמודה הגבוהה יותר. לדוגמה, אם העמודה הראשונה גבוהה יותר מהעמודה השנייה, הגובה של שתי העמודות יהיה כגובה העמודה הראשונה. כל עמודה יכולה להכיל מספר שונה של ווידג'טים, ולכן אי אפשר להגדיר שורות או ליישר ווידג'טים בין העמודות.
העמודות מוצגות זו לצד זו. אפשר להתאים אישית את הרוחב של כל עמודה באמצעות השדה HorizontalSizeStyle. אם רוחב המסך של המשתמש צר מדי, העמודה השנייה תוצג מתחת לעמודה הראשונה:
- באינטרנט, העמודה השנייה עוברת לשורה חדשה אם רוחב המסך קטן מ-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 | ההגדרה הזו קובעת את סגנון הגלישה של העמודות, ושולטת באופן שינוי הגודל של העמודה על סמך רוחב המסך. |
תיעוד מפורט
addColumn(column)
הוספה של Column לווידג'ט 'עמודות'. העמודות מוצגות לפי הסדר שבו הן נוספו. אפשר להוסיף עד שתי עמודות.
const columns = CardService.newColumns().addColumn(CardService.newColumn());
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
column | Column | עמודה של ילד או ילדה שרוצים להוסיף לווידג'ט Columns (עמודות). |
חזרה
Columns – האובייקט הזה, לשרשור.
addEventAction(eventAction)
מוסיף את פעולת האירוע שאפשר לבצע בווידג'ט.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
event | Event | ה-Event שרוצים להוסיף. |
חזרה
Widget – האובייקט, לשרשור.
setId(id)
מגדיר את המזהה הייחודי שהוקצה לשימוש בזיהוי הווידג'ט שצריך לשנות. שינוי של ווידג'ט נתמך רק בתוספים.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
id | String | המזהה של הווידג'ט, עם מגבלה של 64 תווים ובפורמט [a-zA-Z0-9-]+. |
חזרה
Widget – האובייקט הזה, לשרשור.
setVisibility(visibility)
ההגדרה הזו קובעת את רמת החשיפה של הווידג'ט. ערך ברירת המחדל הוא `VISIBLE`.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
visibility | Visibility | הVisibility של הווידג'ט. |
חזרה
Widget – האובייקט, לשרשור.
setWrapStyle(wrapStyle)
ההגדרה הזו קובעת את סגנון הגלישה של העמודות, ושולטת באופן שינוי הגודל של העמודה על סמך רוחב המסך.
const columns = CardService.newColumns() .addColumn(CardService.newColumn()) .setWrapStyle(CardService.WrapStyle.WRAP);
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
wrap | Wrap | סגנון הגלישה שרוצים להגדיר לעמודות. |
חזרה
Columns – האובייקט הזה, לשרשור.