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

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
addWidget(widget)	CardSection	تُضيف هذه الوسيطة التطبيق المصغّر المحدّد إلى هذا القسم.
setCollapseControl(collapseControl)	CardSection	تُستخدَم لضبط أزرار التوسيع والتصغير القابلة للتخصيص للقسم.
setCollapsible(collapsible)	CardSection	لتحديد ما إذا كان يمكن تصغير القسم.
setHeader(header)	CardSection	لضبط عنوان القسم
setNumUncollapsibleWidgets(numUncollapsibleWidgets)	CardSection	لتحديد عدد التطبيقات المصغّرة التي ستظل معروضة عند تصغير هذا القسم.

مستندات تفصيلية

addWidget(widget)

تُضيف هذه الوسيطة التطبيق المصغّر المحدّد إلى هذا القسم. تظهر التطبيقات المصغّرة بالترتيب الذي تمت إضافتها به. لا يمكنك إضافة أكثر من 100 تطبيق مصغّر إلى قسم بطاقة.

المعلَمات

الاسم	النوع	الوصف
widget	Widget	تطبيق مصغّر لإضافته إلى القسم

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
collapseControl	CollapseControl	إعداد عنصر التحكّم في التصغير

الإرجاع

CardSection: هذا العنصر، لإنشاء سلسلة.

---

setCollapsible(collapsible)

لتحديد ما إذا كان يمكن تصغير القسم.

المعلَمات

الاسم	النوع	الوصف
collapsible	Boolean	الإعداد القابل للتصغير

الإرجاع

CardSection: هذا العنصر، لإنشاء سلسلة.

---

setHeader(header)

لضبط عنوان القسم اختيارية:

المعلَمات

الاسم	النوع	الوصف
header	String	نص العنوان

الإرجاع

CardSection: هذا العنصر، لإنشاء سلسلة.

---

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

لتحديد عدد التطبيقات المصغّرة التي ستظل معروضة عند تصغير هذا القسم. التطبيقات المصغّرة المعروضة هي دائمًا التطبيقات المصغّرة الأولى التي تمت إضافتها.

المعلَمات

الاسم	النوع	الوصف
numUncollapsibleWidgets	Integer	عدد التطبيقات المصغّرة المطلوب عرضها

الإرجاع

CardSection: هذا العنصر، لإنشاء سلسلة.