Class Switch

Cambia

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

MetodoTipo restituitoBreve descrizione
setControlType(controlType)SwitchImposta il tipo di controllo del sensore.
setFieldName(fieldName)SwitchImposta la chiave che identifica questa opzione nell'oggetto evento che viene generato se è presente un'opzione Interazione con l'interfaccia utente.
setOnChangeAction(action)SwitchImposta l'azione da eseguire quando l'opzione viene attivata/disattivata.
setSelected(selected)SwitchConsente di impostare se questa opzione deve iniziare come selezionata o deselezionata.
setValue(value)SwitchImposta 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

NomeTipoDescrizione
controlTypeSwitchControlTypeIl 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

NomeTipoDescrizione
fieldNameStringLa chiave utilizzata per identificare il sensore.

Invio

Switch: oggetto per il collegamento.


setOnChangeAction(action)

Imposta l'azione da eseguire quando l'opzione viene attivata/disattivata.

Parametri

NomeTipoDescrizione
actionActionL'azione da eseguire quando l'opzione viene attivata/disattivata.

Invio

Switch: oggetto per il collegamento.


setSelected(selected)

Consente di impostare se questa opzione deve iniziare come selezionata o deselezionata.

Parametri

NomeTipoDescrizione
selectedBooleanL'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

NomeTipoDescrizione
valueStringIl 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.