تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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: هذا العنصر، لإنشاء سلسلة.