Class CardSection

CardSection

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

זמין לתוספים ל-Google Workspace ולאפליקציות ל-Google Chat. 

const image = CardService.newImage();
// Build image ...
const textParagraph = CardService.newTextParagraph();
// Build text paragraph ...

const cardSection = CardService.newCardSection()
                        .setHeader('Section header')
                        .addWidget(image)
                        .addWidget(textParagraph);

Methods

שיטהסוג הערך שמוחזרתיאור קצר
addWidget(widget)CardSectionהוספת הווידג'ט שצוין לקטע הזה.
setCollapseControl(collapseControl)CardSectionהגדרת כפתורי ההרחבה והכיווץ של הקטע, שאפשר להתאים אותם אישית.
setCollapsible(collapsible)CardSectionהגדרה שקובעת אם אפשר לכווץ את הקטע.
setHeader(header)CardSectionהגדרת הכותרת של הקטע.
setId(id)CardSectionמגדיר את המזהה הייחודי שהוקצה ומשמש לזיהוי הקטע שצריך לשנות.
setNumUncollapsibleWidgets(numUncollapsibleWidgets)CardSectionהגדרה של מספר הווידג'טים שעדיין יוצגו כשהקטע הזה מכווץ.

תיעוד מפורט

addWidget(widget)

הוספת הווידג'ט שצוין לקטע הזה. הווידג'טים מוצגים לפי הסדר שבו הם נוספו. אי אפשר להוסיף יותר מ-100 ווידג'טים לקטע של כרטיס.

פרמטרים

שםסוגתיאור
widgetWidgetווידג'ט להוספה לקטע.

חזרה

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

setCollapseControl(collapseControl)

הגדרת כפתורי ההרחבה והכיווץ של הקטע, שאפשר להתאים אותם אישית. הכפתורים האלה מוצגים רק אם אפשר לכווץ את הקטע. אם השדה הזה לא מוגדר, המערכת משתמשת בלחצני ברירת מחדל.

זמין באפליקציות שפועלות עם Google Chat. בתצוגה מקדימה למפתחים של תוספים ל-Google Workspace. 

const collapseButton =
    CardService.newTextButton()
        .setTextButtonStyle(CardService.TextButtonStyle.BORDERLESS)
        .setText('show less');

const expandButton =
    CardService.newImageButton()
        .setImageButtonStyle(CardService.ImageButtonStyle.FILLED)
        .setMaterialIcon(CardService.newMaterialIcon().setName('bug_report'));

const collapsibleSection =
    CardService.newCardSection()
        .setCollapsible(true)
        .setNumUncollapsibleWidgets(1)
        .setCollapseControl(
            CardService.newCollapseControl()
                .setHorizontalAlign(CardService.HorizontalAlignment.CENTER)
                .setCollapseButton(collapseButton)
                .setExpandButton(expandButton),
        );

פרמטרים

שםסוגתיאור
collapseControlCollapseControlהגדרת אמצעי הבקרה לצמצום.

חזרה

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

setCollapsible(collapsible)

הגדרה שקובעת אם אפשר לכווץ את הקטע.

פרמטרים

שםסוגתיאור
collapsibleBooleanההגדרה של האפשרות לצמצם את התצוגה.

חזרה

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

setHeader(header)

הגדרת הכותרת של הקטע. אופציונלי.

פרמטרים

שםסוגתיאור
headerStringטקסט הכותרת.

חזרה

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

setId(id)

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

פרמטרים

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

חזרה

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

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

הגדרה של מספר הווידג'טים שעדיין יוצגו כשהקטע הזה מכווץ. הווידג'טים שמוצגים הם תמיד הראשונים שהוספתם.

פרמטרים

שםסוגתיאור
numUncollapsibleWidgetsIntegerמספר הווידג'טים שיוצגו.

חזרה

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