Class CardSection

KartaSekcja

Sekcja karty zawiera grupy widżetów i zapewnia wizualne oddzielenie między nimi.

Dostępne w przypadku dodatków do Google Workspace i aplikacji do 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);

Metody

MetodaZwracany typKrótki opis
addWidget(widget)CardSectionDodaje podany widżet do tej sekcji.
setCollapseControl(collapseControl)CardSectionUstawia konfigurowalne przyciski rozwijania i zwijania sekcji.
setCollapsible(collapsible)CardSectionOkreśla, czy sekcję można zwinąć.
setHeader(header)CardSectionUstawia nagłówek sekcji.
setId(id)CardSectionUstawia unikalny identyfikator przypisany do sekcji, która ma zostać zmieniona.
setNumUncollapsibleWidgets(numUncollapsibleWidgets)CardSectionOkreśla liczbę widżetów, które są nadal widoczne po zwinięciu tej sekcji.

Szczegółowa dokumentacja

addWidget(widget)

Dodaje podany widżet do tej sekcji. Widżety są wyświetlane w kolejności, w jakiej zostały dodane. Nie możesz dodać do sekcji karty więcej niż 100 widżetów.

Parametry

NazwaTypOpis
widgetWidgetWidżet do dodania w sekcji.

Powrót

CardSection – ten obiekt do łączenia.

setCollapseControl(collapseControl)

Ustawia konfigurowalne przyciski rozwijania i zwijania sekcji. Te przyciski są widoczne tylko wtedy, gdy sekcja jest zwijalna. Jeśli to pole nie jest skonfigurowane, używane są domyślne przyciski.

Dostępne w przypadku aplikacji Google Chat. W wersji przedpremierowej dla programistów dodatków do 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),
        );

Parametry

NazwaTypOpis
collapseControlCollapseControlUstawienie elementu sterującego zwijaniem.

Powrót

CardSection – ten obiekt do łączenia.

setCollapsible(collapsible)

Określa, czy sekcję można zwinąć.

Parametry

NazwaTypOpis
collapsibleBooleanUstawienie zwijania.

Powrót

CardSection – ten obiekt do łączenia.

setHeader(header)

Ustawia nagłówek sekcji. Opcjonalnie:

Parametry

NazwaTypOpis
headerStringTekst nagłówka.

Powrót

CardSection – ten obiekt do łączenia.

setId(id)

Ustawia przypisany unikalny identyfikator, który służy do identyfikowania sekcji, która ma zostać zmieniona. Zmiana sekcji jest obsługiwana tylko w przypadku dodatków.

Parametry

NazwaTypOpis
idStringIdentyfikator sekcji, który może mieć maksymalnie 64 znaki i musi mieć format `[a-zA-Z0-9-]+`.

Powrót

CardSection – ten obiekt do łączenia.

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

Określa liczbę widżetów, które są nadal widoczne po zwinięciu tej sekcji. Wyświetlane widżety to zawsze te, które zostały dodane jako pierwsze.

Parametry

NazwaTypOpis
numUncollapsibleWidgetsIntegerLiczba widżetów do wyświetlenia.

Powrót

CardSection – ten obiekt do łączenia.