Class Columns

Колонны

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

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

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

  • На веб-страницах второй столбец переносится, если ширина экрана меньше или равна 480 пикселям.
  • На устройствах iOS второй столбец переносится, если ширина экрана меньше или равна 300 пт.
  • На устройствах 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 Задает стиль переноса столбцов, управляет изменением размера столбца в зависимости от ширины экрана.

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

add Column(column)

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

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

Параметры

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

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

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

add Event Action(eventAction)

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

Параметры

Имя Тип Описание
event Action Event Action Будет добавлено Event Action .

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

Widget — Объект, для объединения в цепочку.

set Id(id)

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

Параметры

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

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

Widget — объект для объединения в цепочку.

set Visibility(visibility)

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

Параметры

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

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

Widget — Объект, для объединения в цепочку.

set Wrap Style(wrapStyle)

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

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

Параметры

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

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

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