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)

Добавляет указанный виджет в этот раздел. Виджеты отображаются в порядке их добавления. В раздел карточек можно добавить не более 100 виджетов.

Параметры

Имя Тип Описание
widget Widget Виджет для добавления в раздел.

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

Card Section — Этот объект предназначен для объединения в цепочку.

set Collapse Control(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 Настройка контроля коллапса.

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

Card Section — Этот объект предназначен для объединения в цепочку.

set Collapsible(collapsible)

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

Параметры

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

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

Card Section — Этот объект предназначен для объединения в цепочку.

set Header(header)

Задаёт заголовок раздела. Необязательно.

Параметры

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

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

Card Section — Этот объект предназначен для объединения в цепочку.

set Id(id)

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

Параметры

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

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

Card Section — Этот объект предназначен для объединения в цепочку.

set Num Uncollapsible Widgets(numUncollapsibleWidgets)

Устанавливает количество виджетов, которые будут отображаться при свёртывании раздела. Отображаются всегда первые добавленные виджеты.

Параметры

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

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

Card Section — Этот объект предназначен для объединения в цепочку.