Class Switch

Выключатель

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

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

var 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")));

Методы

Метод Тип возврата Краткое описание
setControlType(controlType) Switch Устанавливает тип управления переключателем.
setFieldName(fieldName) Switch Устанавливает ключ, идентифицирующий этот переключатель, в объекте события, который создается при взаимодействии пользовательского интерфейса.
setOnChangeAction(action) Switch Устанавливает действие, которое необходимо выполнить при переключении переключателя.
setSelected(selected) Switch Устанавливает, должен ли этот переключатель запускаться как выбранный или невыбранный.
setValue(value) Switch Устанавливает значение, которое отправляется в качестве входных данных формы, когда этот переключатель включен.

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

setControlType(controlType)

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

Параметры

Имя Тип Описание
controlType SwitchControlType Тип управления переключателем.

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

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


setFieldName(fieldName)

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

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

Параметры

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

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

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


setOnChangeAction(action)

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

Параметры

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

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

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


setSelected(selected)

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

Параметры

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

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

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


setValue(value)

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

Параметры

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

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

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