Class Columns

Колонки

Виджет « Columns отображает до 2 столбцов в карточке или диалоговом окне. Вы можете добавить виджеты в каждый Column ; виджеты отображаются в том порядке, в котором они указаны. Пример использования в приложениях Google Chat см. в разделе «Столбцы» .

Высота каждого столбца определяется высотой более высокого столбца. Например, если первый столбец выше второго, то оба столбца будут иметь высоту первого столбца. Поскольку каждый столбец может содержать разное количество виджетов, нельзя определять строки или выравнивать виджеты между столбцами.

Столбцы отображаются рядом друг с другом. Вы можете настроить ширину каждого столбца с помощью поля HorizontalSizeStyle . Если ширина экрана пользователя слишком мала, второй столбец будет переноситься ниже первого:

  • В веб-браузере второй столбец переносится на следующую строку, если ширина экрана меньше или равна 480 пикселям.
  • На устройствах iOS второй столбец переносится на следующую строку, если ширина экрана меньше или равна 300 pt.
  • На устройствах Android второй столбец переносится на следующую строку, если ширина экрана меньше или равна 320 dp.

Доступно для приложений Google Chat и дополнений Google Workspace. К дополнениям, поддерживающим столбцы, относятся:

  • Диалоговое окно, отображаемое при открытии пользователями дополнения из черновика электронного письма.
  • Диалоговое окно, отображаемое при открытии пользователями дополнения из меню «Добавить вложение» в событии календаря Google. 
    // Build a column that is aligned in the center and fills the space:
const column =
    CardService.newColumn()
        .setHorizontalSizeStyle(
            CardService.HorizontalSizeStyle.FILL_AVAILABLE_SPACE)
        .setHorizontalAlignment(CardService.HorizontalAlignment.CENTER)
        .setVerticalAlignment(CardService.VerticalAlignment.CENTER);
const columns = CardService.newColumns().addColumn(column).setWrapStyle(
    CardService.WrapStyle.WRAP);

Методы

Метод Тип возвращаемого значения Краткое описание
add Column(column) Columns Добавляет Column в виджет «Столбцы».
add Event Action(eventAction) Widget Добавляет действие события, которое можно выполнить с виджетом.
set Id(id) Widget Задает уникальный идентификатор, используемый для идентификации виджета, подлежащего изменению.
set Visibility(visibility) Widget Задает видимость виджета.
set Wrap Style(wrapStyle) Columns Задает стиль переноса строк в столбцах, управляет изменением размера столбцов в зависимости от ширины экрана.

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

addColumn(column)

Добавляет Column в виджет «Столбцы». Столбцы отображаются в порядке их добавления. Можно добавить до двух столбцов.

const columns = CardService.newColumns().addColumn(CardService.newColumn());

Параметры

Имя Тип Описание
column Column Дочерний столбец для добавления в виджет «Столбцы».

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

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

addEventAction(eventAction)

Добавляет действие события, которое можно выполнить с виджетом.

Параметры

Имя Тип Описание
event Action Event Action Необходимо добавить Event Action .

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

Widget — Объект для создания цепочек.

setId(id)

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

Параметры

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

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

Widget — этот объект используется для создания цепочек вызовов.

setVisibility(visibility)

Задает видимость виджета. Значение по умолчанию — `VISIBLE`.

Параметры

Имя Тип Описание
visibility Visibility Visibility виджета.

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

Widget — Объект для создания цепочек.

setWrapStyle(wrapStyle)

Задает стиль переноса строк в столбцах, управляет изменением размера столбцов в зависимости от ширины экрана.

const columns = CardService.newColumns()
                    .addColumn(CardService.newColumn())
                    .setWrapStyle(CardService.WrapStyle.WRAP);

Параметры

Имя Тип Описание
wrap Style Wrap Style Стиль переноса текста для столбцов.

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

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