Class Switch

开关

支持开启或关闭的界面元素。此元素只能在 DecoratedText widget 中使用。

适用于 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'),
                    ),
        );

方法

方法	返回类型	简介
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 - 此对象，用于链式调用。