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 Задает количество виджетов, которые остаются видимыми, когда этот раздел свернут.

Подробная документация

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

Параметры

Имя Тип Описание
collapse Control Collapse Control Настройка управления сворачиванием.

Возвращаться

CardSection — Этот объект используется для создания цепочек.

setCollapsible(collapsible)

Определяет, можно ли свернуть раздел.

Параметры

Имя Тип Описание
collapsible Boolean Складная настройка.

Возвращаться

CardSection — Этот объект используется для создания цепочек.

setHeader(header)

Задает заголовок раздела. Необязательный параметр.

Параметры

Имя Тип Описание
header String Текст заголовка.

Возвращаться

CardSection — Этот объект используется для создания цепочек.

setId(id)

Задает уникальный идентификатор, используемый для идентификации раздела, подлежащего изменению. Изменение разделов поддерживается только в дополнениях.

Параметры

Имя Тип Описание
id String Идентификатор раздела, ограниченный 64 символами и в формате `[a-zA-Z0-9-]+`.

Возвращаться

CardSection — Этот объект используется для создания цепочек.

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

Задает количество виджетов, которые остаются видимыми, когда этот раздел свернут. Всегда отображаются первые добавленные виджеты.

Параметры

Имя Тип Описание
num Uncollapsible Widgets Integer Количество отображаемых виджетов.

Возвращаться

CardSection — Этот объект используется для создания цепочек.