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 ווידג'טים לקטע של כרטיס.

פרמטרים

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

חזרה

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

---

setCollapseControl(collapseControl)

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

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

גרסת Developer Preview: זמינה כחלק מתוכנית Google Workspace Developer Preview, שמעניקה גישה מוקדמת לתכונות מסוימות.

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),
        );

פרמטרים

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

חזרה

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

---

setCollapsible(collapsible)

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

פרמטרים

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

חזרה

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

---

setHeader(header)

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

פרמטרים

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

חזרה

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

---

setId(id)

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

פרמטרים

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

חזרה

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

---

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

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

פרמטרים

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

חזרה

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