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: هذا العنصر، للتسلسل