Un elemento UI che supporta l'attivazione o la disattivazione. Può essere utilizzato solo all'interno di un widget DecoratedText.
Disponibile per i componenti aggiuntivi di Google Workspace e le app 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")));
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
setControlType(controlType) | Switch | Imposta il tipo di controllo del sensore. |
setFieldName(fieldName) | Switch | Imposta la chiave che identifica questa opzione nell'oggetto evento che viene generato se è presente un'opzione Interazione con l'interfaccia utente. |
setOnChangeAction(action) | Switch | Imposta l'azione da eseguire quando l'opzione viene attivata/disattivata. |
setSelected(selected) | Switch | Consente di impostare se questa opzione deve iniziare come selezionata o deselezionata. |
setValue(value) | Switch | Imposta il valore che viene inviato come input del modulo quando questa opzione viene attivata. |
Documentazione dettagliata
setControlType(controlType)
Imposta il tipo di controllo del sensore. Il valore predefinito è SWITCH.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
controlType | SwitchControlType | Il tipo di controllo dell'interruttore. |
Invio
Switch: oggetto per il collegamento.
setFieldName(fieldName)
Imposta la chiave che identifica questa opzione nell'oggetto evento che viene generato se è presente un'opzione Interazione con l'interfaccia utente. Non visibile all'utente. Obbligatorio.
A differenza di altri campi del modulo, questo nome non deve essere necessariamente univoco. I valori di input del modulo per i sensori che usano lo stesso nome di campo vengono restituiti come array. L'array è composto da per tutte le opzioni attivate con il nome del campo in questione.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
fieldName | String | La chiave utilizzata per identificare il sensore. |
Invio
Switch: oggetto per il collegamento.
setOnChangeAction(action)
setSelected(selected)
Consente di impostare se questa opzione deve iniziare come selezionata o deselezionata.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
selected | Boolean | L'impostazione dello stato iniziale. |
Invio
Switch: oggetto per il collegamento.
setValue(value)
Imposta il valore che viene inviato come input del modulo quando questa opzione viene attivata.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
value | String | Il valore associato al nome quando l'opzione è attiva. Quando questa informazione viene inviata il callback al modulo, è sempre rappresentato come una stringa. |
Invio
Switch: oggetto per il collegamento.