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.