Class Switch

Выключатель

Элемент пользовательского интерфейса, который поддерживает включение и выключение. Это можно использовать только в виджете Decorated Text .

Доступно для дополнений Google Workspace и приложений Google Chat.

const switchDecoratedText =
    CardService.newDecoratedText()
        .setTopLabel('Switch decorated text widget label')
        .setText('This is a decorated text widget with a switch on the right')
        .setWrapText(true)
        .setSwitchControl(
            CardService.newSwitch()
                .setFieldName('form_input_switch_key')
                .setValue('form_input_switch_value')
                .setOnChangeAction(
                    CardService.newAction().setFunctionName(
                        'handleSwitchChange'),
                    ),
        );

Методы

Метод Тип возврата Краткое описание
set Control Type(controlType) Switch Устанавливает тип управления переключателем.
set Field Name(fieldName) Switch Устанавливает ключ, идентифицирующий этот переключатель, в объекте события, который создается при взаимодействии пользовательского интерфейса.
set On Change Action(action) Switch Устанавливает действие, которое необходимо выполнить при переключении переключателя.
set Selected(selected) Switch Устанавливает, должен ли этот переключатель запускаться как выбранный или невыбранный.
set Value(value) Switch Устанавливает значение, которое отправляется в качестве входных данных формы, когда этот переключатель включен.

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

set Control Type(controlType)

Устанавливает тип управления переключателем. По умолчанию SWITCH .

Параметры

Имя Тип Описание
control Type Switch Control Type Тип управления переключателем.

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

Switch — этот объект для цепочки.


set Field Name(fieldName)

Устанавливает ключ, идентифицирующий этот переключатель, в объекте события, который создается при взаимодействии пользовательского интерфейса. Не виден пользователю. Необходимый.

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

Параметры

Имя Тип Описание
field Name String Ключ, который используется для идентификации этого переключателя.

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

Switch — этот объект для цепочки.


set On Change Action(action)

Устанавливает действие, которое необходимо выполнить при переключении переключателя.

Параметры

Имя Тип Описание
action Action Действие, которое необходимо предпринять при переключении переключателя.

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

Switch — этот объект для цепочки.


set Selected(selected)

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

Параметры

Имя Тип Описание
selected Boolean Настройка состояния пускового переключателя.

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

Switch — этот объект для цепочки.


set Value(value)

Устанавливает значение, которое отправляется в качестве входных данных формы, когда этот переключатель включен.

Параметры

Имя Тип Описание
value String Значение, связанное с именем, когда переключатель включен. Когда это отправляется в обратный вызов формы, оно всегда представляется в виде строки.

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

Switch — этот объект для цепочки.