Class Switch

切換

支援開啟或關閉的 UI 元素。這只能在 DecoratedText 小工具中使用。

適用於 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設定在發生 UI 互動時產生的事件物件中，用於識別這個切換鈕的鍵。
setOnChangeAction(action)Switch設定切換開關切換時要採取的動作。
setSelected(selected)Switch設定這個切換鈕的初始狀態為選取或未選取。
setValue(value)Switch設定這個切換鈕開啟時要傳送的表單輸入內容。

內容詳盡的說明文件

setControlType(controlType)

設定切換按鈕的控制項類型。預設值為 SWITCH。

參數

名稱類型說明
controlTypeSwitchControlType切換控制項類型。

回攻員

Switch - 這個物件，用於鏈結。

setFieldName(fieldName)

設定在發生 UI 互動時產生的事件物件中，用於識別這個切換鈕的金鑰。使用者不會看到這項資訊。必要欄位。

與其他表單欄位不同，這個欄位名稱不必是專屬名稱。使用相同欄位名稱的切換開關，其表單輸入值會以陣列形式傳回。這個陣列包含所有已啟用切換鈕的值，以及該欄位名稱。

參數

名稱類型說明
fieldNameString用來識別這個交換器的金鑰。

回攻員

Switch - 這個物件，用於鏈結。

setOnChangeAction(action)

設定切換開關切換時要採取的動作。

參數

名稱類型說明
actionAction切換開關時要採取的動作。

回攻員

Switch - 這個物件，用於鏈結。

setSelected(selected)

設定這個切換鈕的初始狀態為選取或未選取。

參數

名稱類型說明
selectedBoolean開關的初始狀態設定。

回攻員

Switch - 這個物件，用於鏈結。

setValue(value)

設定這個切換鈕開啟時要傳送的表單輸入內容。

參數

名稱類型說明
valueString切換鈕開啟時與名稱相關聯的值。當這個值傳送至表單回呼時，一律會以字串表示。

回攻員

Switch - 這個物件，用於鏈結。