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 – האובייקט הזה, לשרשור.