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

الطُرق

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
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

إصدار تجريبي للمطوّرين: يتوفّر كجزء من برنامج الإصدار التجريبي للمطوّرين في 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: هذا الكائن، للتسلسل

---

setId(id)

تضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد القسم الذي سيتمّ تعديله. لا يمكن تعديل الأقسام إلا في "الإضافات".

المعلمات

الاسم	النوع	الوصف
id	String	معرّف القسم، ويجب ألّا يتجاوز 64 حرفًا وأن يكون بالتنسيق `[a-zA-Z0-9-]+`.

الإرجاع

CardSection: هذا الكائن، للتسلسل

---

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

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

المعلمات

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

الإرجاع

CardSection: هذا الكائن، للتسلسل