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

روش‌ها

روش نوع بازگشتی شرح مختصر
add Widget(widget) Card Section ابزارک داده شده را به این بخش اضافه می‌کند.
set Collapse Control(collapseControl) Card Section دکمه‌های قابل تنظیم برای باز و بسته کردن بخش را تنظیم می‌کند.
set Collapsible(collapsible) Card Section تعیین می‌کند که آیا می‌توان بخش را جمع کرد یا خیر.
set Header(header) Card Section سربرگ بخش را تنظیم می‌کند.
set Id(id) Card Section شناسه منحصر به فردی را که برای شناسایی بخش مورد نظر برای جهش استفاده می‌شود، تنظیم می‌کند.
set Num Uncollapsible Widgets(numUncollapsibleWidgets) Card Section تعداد ویجت‌هایی را که هنگام بسته شدن این بخش همچنان نمایش داده می‌شوند، تنظیم می‌کند.

مستندات دقیق

add Widget(widget)

ابزارک داده شده را به این بخش اضافه می‌کند. ابزارک‌ها به ترتیبی که اضافه شده‌اند نمایش داده می‌شوند. نمی‌توانید بیش از ۱۰۰ ابزارک به یک بخش کارت اضافه کنید.

پارامترها

نام نوع توضیحات
widget Widget یک ویجت برای اضافه کردن به بخش.

بازگشت

Card Section - این شیء، برای زنجیره‌سازی.

set Collapse Control(collapseControl)

دکمه‌های قابل تنظیم برای باز و بسته کردن بخش را تنظیم می‌کند. این دکمه‌ها فقط در صورتی نمایش داده می‌شوند که بخش قابل باز و بسته شدن باشد. اگر این فیلد تنظیم نشده باشد، از دکمه‌های پیش‌فرض استفاده می‌شود.

برای برنامه‌های چت گوگل موجود است. در پیش‌نمایش توسعه‌دهندگان برای افزونه‌های 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),
        );

پارامترها

نام نوع توضیحات
collapse Control Collapse Control تنظیمات کنترل فروپاشی.

بازگشت

Card Section - این شیء، برای زنجیره‌سازی.

set Collapsible(collapsible)

تعیین می‌کند که آیا می‌توان بخش را جمع کرد یا خیر.

پارامترها

نام نوع توضیحات
collapsible Boolean تنظیمات قابل جمع شدن.

بازگشت

Card Section - این شیء، برای زنجیره‌سازی.

set Header(header)

عنوان بخش را تنظیم می‌کند. اختیاری.

پارامترها

نام نوع توضیحات
header String متن سربرگ.

بازگشت

Card Section - این شیء، برای زنجیره‌سازی.

set Id(id)

شناسه منحصر به فردی را که برای شناسایی بخش مورد نظر برای تغییر استفاده می‌شود، تنظیم می‌کند. تغییر بخش فقط در افزونه‌ها پشتیبانی می‌شود.

پارامترها

نام نوع توضیحات
id String شناسه‌ی بخش، با محدودیت ۶۴ کاراکتر و با فرمت `[a-zA-Z0-9-]+`.

بازگشت

Card Section - این شیء، برای زنجیره‌سازی.

set Num Uncollapsible Widgets(numUncollapsibleWidgets)

تعداد ویجت‌هایی که هنگام بسته شدن این بخش همچنان نمایش داده می‌شوند را تنظیم می‌کند. ویجت‌های نمایش داده شده همیشه اولین ویجت‌هایی هستند که اضافه شده‌اند.

پارامترها

نام نوع توضیحات
num Uncollapsible Widgets Integer تعداد ویجت‌هایی که نمایش داده می‌شوند.

بازگشت

Card Section - این شیء، برای زنجیره‌سازی.