تمت ترجمة هذه الصفحة بواسطة 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: هذا العنصر، لإنشاء سلسلة.