Class Columns

עמודות

בווידג'ט 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

שיטהסוג הערך שמוחזרתיאור קצר
addColumn(column)Columnsהוספה של Column לווידג'ט 'עמודות'.
addEventAction(eventAction)Widgetמוסיף את פעולת האירוע שאפשר לבצע בווידג'ט.
setId(id)Widgetמגדיר את המזהה הייחודי שהוקצה לשימוש בזיהוי הווידג'ט שצריך לשנות.
setVisibility(visibility)Widgetההגדרה הזו קובעת את רמת החשיפה של הווידג'ט.
setWrapStyle(wrapStyle)Columnsההגדרה הזו קובעת את סגנון הגלישה של העמודות, ושולטת באופן שינוי הגודל של העמודה על סמך רוחב המסך.

תיעוד מפורט

addColumn(column)

הוספה של Column לווידג'ט 'עמודות'. העמודות מוצגות לפי הסדר שבו הן נוספו. אפשר להוסיף עד שתי עמודות.

const columns = CardService.newColumns().addColumn(CardService.newColumn());

פרמטרים

שםסוגתיאור
columnColumnעמודה של ילד או ילדה שרוצים להוסיף לווידג'ט Columns (עמודות).

חזרה

Columns – האובייקט הזה, לשרשור.


addEventAction(eventAction)

מוסיף את פעולת האירוע שאפשר לבצע בווידג'ט.

פרמטרים

שםסוגתיאור
eventActionEventActionה-EventAction שרוצים להוסיף.

חזרה

Widget – האובייקט, לשרשור.


setId(id)

מגדיר את המזהה הייחודי שהוקצה לשימוש בזיהוי הווידג'ט שצריך לשנות. שינוי של ווידג'ט נתמך רק בתוספים.

פרמטרים

שםסוגתיאור
idStringהמזהה של הווידג'ט, עם מגבלה של 64 תווים ובפורמט [a-zA-Z0-9-]+.

חזרה

Widget – האובייקט הזה, לשרשור.


setVisibility(visibility)

ההגדרה הזו קובעת את רמת החשיפה של הווידג'ט. ערך ברירת המחדל הוא `VISIBLE`.

פרמטרים

שםסוגתיאור
visibilityVisibilityהVisibility של הווידג'ט.

חזרה

Widget – האובייקט, לשרשור.


setWrapStyle(wrapStyle)

ההגדרה הזו קובעת את סגנון הגלישה של העמודות, ושולטת באופן שינוי הגודל של העמודה על סמך רוחב המסך.

const columns = CardService.newColumns()
                    .addColumn(CardService.newColumn())
                    .setWrapStyle(CardService.WrapStyle.WRAP);

פרמטרים

שםסוגתיאור
wrapStyleWrapStyleסגנון הגלישה שרוצים להגדיר לעמודות.

חזרה

Columns – האובייקט הזה, לשרשור.