Class SelectionInput

Input di selezione

Un campo di immissione che consente di scegliere tra un insieme di opzioni predefinite.

var checkboxGroup = CardService.newSelectionInput()
    .setType(CardService.SelectionInputType.CHECK_BOX)
    .setTitle("A group of checkboxes. Multiple selections are allowed.")
    .setFieldName("checkbox_field")
    .addItem("checkbox one title", "checkbox_one_value", false)
    .addItem("checkbox two title", "checkbox_two_value", true)
    .addItem("checkbox three title", "checkbox_three_value", true)
    .setOnChangeAction(CardService.newAction()
        .setFunctionName("handleCheckboxChange"));

var radioGroup = CardService.newSelectionInput()
    .setType(CardService.SelectionInputType.RADIO_BUTTON)
    .setTitle("A group of radio buttons. Only a single selection is allowed.")
    .setFieldName("checkbox_field")
    .addItem("radio button one title", "radio_one_value", true)
    .addItem("radio button two title", "radio_two_value", false)
    .addItem("radio button three title", "radio_three_value", false);

Metodi

MetodoTipo restituitoBreve descrizione
addItem(text, value, selected)SelectionInputAggiunge un nuovo elemento selezionabile.
setFieldName(fieldName)SelectionInputImposta la chiave che identifica questo input di selezione nell'oggetto evento che viene generato quando si verifica un'interazione con l'interfaccia utente.
setOnChangeAction(action)SelectionInputImposta un Action da eseguire ogni volta che l'input della selezione cambia.
setTitle(title)SelectionInputImposta il titolo da visualizzare prima del campo di immissione.
setType(type)SelectionInputConsente di impostare il tipo di questo input.

Documentazione dettagliata

addItem(text, value, selected)

Aggiunge un nuovo elemento selezionabile.

Parametri

NomeTipoDescrizione
textObjectIl testo da mostrare per l'elemento. Gli argomenti primitivi non in stringa vengono convertiti automaticamente in stringhe.
valueObjectIl valore di input del modulo inviato tramite il callback. Gli argomenti primitivi non stringa vengono convertiti automaticamente in stringhe.
selectedBooleanIndica se l'elemento deve iniziare come selezionato o deselezionato.

Andata e ritorno

SelectionInput: questo oggetto, per il concatenamento.


setFieldName(fieldName)

Imposta la chiave che identifica questo input di selezione nell'oggetto evento che viene generato quando si verifica un'interazione con l'interfaccia utente. Non sarà visibile all'utente. È obbligatorio, deve essere univoco.

Parametri

NomeTipoDescrizione
fieldNameStringIl nome da assegnare a questo input.

Andata e ritorno

SelectionInput: questo oggetto, per il concatenamento.


setOnChangeAction(action)

Imposta un Action da eseguire ogni volta che l'input della selezione cambia.

Parametri

NomeTipoDescrizione
actionActione l'azione da eseguire.

Andata e ritorno

SelectionInput: questo oggetto, per il concatenamento.


setTitle(title)

Imposta il titolo da visualizzare prima del campo di immissione.

Parametri

NomeTipoDescrizione
titleStringIl titolo del campo di immissione.

Andata e ritorno

SelectionInput: questo oggetto, per il concatenamento.


setType(type)

Consente di impostare il tipo di questo input. Il valore predefinito è CHECKBOX.

Parametri

NomeTipoDescrizione
typeSelectionInputTypeIl tipo di selezione.

Andata e ritorno

SelectionInput: questo oggetto, per il concatenamento.