Element interfejsu, który można włączać i wyłączać. Tej opcji można używać tylko w widżecie DecoratedText.
Dostępne w przypadku dodatków do Google Workspace i aplikacji 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")));
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
setControlType(controlType) | Switch | Ustawia typ elementu sterującego przełącznika. |
setFieldName(fieldName) | Switch | Ustawia klucz identyfikujący ten przełącznik w obiekcie zdarzenia, który jest generowany, gdy w obiekcie Interakcja z interfejsem. |
setOnChangeAction(action) | Switch | Określa działanie, jakie ma być wykonywane po przełączeniu przełącznika. |
setSelected(selected) | Switch | Określa, czy ten przełącznik ma się uruchamiać jako wybrany czy niezaznaczony. |
setValue(value) | Switch | Ustawia wartość, która jest wysyłana jako dane wejściowe formularza, gdy ten przełącznik jest włączony. |
Szczegółowa dokumentacja
setControlType(controlType)
Ustawia typ elementu sterującego przełącznika. Domyślna wartość to SWITCH.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
controlType | SwitchControlType | Typ przełącznika. |
Powrót
Switch – obiekt do tworzenia łańcuchów.
setFieldName(fieldName)
Ustawia klucz identyfikujący ten przełącznik w obiekcie zdarzenia, który jest generowany, gdy w obiekcie Interakcja z interfejsem. Niewidoczne dla użytkownika. Wymagane.
W przeciwieństwie do innych pól formularza nazwa tego pola nie musi być niepowtarzalna. Wartości wejściowe formularza dla przełączników o tej samej nazwie pola są zwracane jako tablica. Tablica składa się z wartości wszystkich włączonych przełączników z tą nazwą pola.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
fieldName | String | Klucz używany do identyfikowania tego przełącznika. |
Powrót
Switch – obiekt do tworzenia łańcuchów.
setOnChangeAction(action)
setSelected(selected)
Określa, czy ten przełącznik ma się uruchamiać jako wybrany czy niezaznaczony.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
selected | Boolean | Początkowe ustawienie stanu przełącznika. |
Powrót
Switch – obiekt do tworzenia łańcuchów.
setValue(value)
Ustawia wartość, która jest wysyłana jako dane wejściowe formularza, gdy ten przełącznik jest włączony.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
value | String | Wartość powiązana z nazwą, gdy przełącznik jest włączony. Gdy jest on wysyłany do formularza wywołania zwrotnego, jest zawsze reprezentowane przez ciąg znaków. |
Powrót
Switch – obiekt do tworzenia łańcuchów.