Elemento dell'interfaccia utente che supporta l'attivazione o la disattivazione. Può essere utilizzato solo all'interno di un widget DecoratedText
.
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 | Consente di impostare il tipo di controllo dell'interruttore. |
setFieldName(fieldName) | Switch | Imposta la chiave che identifica questo sensore nell'oggetto evento generato quando si verifica un'interazione con l'interfaccia utente. |
setOnChangeAction(action) | Switch | Consente di impostare l'azione da eseguire quando l'interruttore è attivato. |
setSelected(selected) | Switch | Consente di stabilire se il selettore deve iniziare come selezionato o deselezionato. |
setValue(value) | Switch | Imposta il valore che viene inviato come input di modulo quando questa opzione è attivata. |
Documentazione dettagliata
setControlType(controlType)
Consente di impostare il tipo di controllo dell'interruttore. Il valore predefinito è SWITCH
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
controlType | SwitchControlType | Il tipo di controllo del sensore. |
Andata e ritorno
Switch
: questo oggetto, per il concatenamento.
setFieldName(fieldName)
Imposta la chiave che identifica questo sensore nell'oggetto evento generato quando si verifica un'interazione con l'interfaccia utente. Non sarà visibile all'utente. Obbligatorio.
A differenza degli altri campi del modulo, il nome non deve essere univoco. I valori di input del modulo per i sensori che utilizzano lo stesso nome di campo vengono restituiti come array. L'array è costituito dai valori per tutti i sensori abilitati che hanno quel nome di campo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fieldName | String | La chiave utilizzata per identificare il sensore. |
Andata e ritorno
Switch
: questo oggetto, per il concatenamento.
setOnChangeAction(action)
setSelected(selected)
Consente di stabilire se il selettore deve iniziare come selezionato o deselezionato.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
selected | Boolean | Avvio dell'impostazione dello stato del sensore. |
Andata e ritorno
Switch
: questo oggetto, per il concatenamento.
setValue(value)
Imposta il valore che viene inviato come input di modulo quando questa opzione è attivata.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | String | Il valore associato al nome quando l'opzione è attiva. Quando viene inviato al callback del modulo, è sempre rappresentato come una stringa. |
Andata e ritorno
Switch
: questo oggetto, per il concatenamento.