Selezione selezione

Il widget SelectionInput offre una serie di elementi selezionabili, come un elenco di caselle di controllo, pulsanti di opzione, opzioni o un menu a discesa.

Il widget supporta i suggerimenti, che consentono agli utenti di inserire dati uniformi e le azioni in modifica, Actions che vengono eseguite quando si verifica una modifica nel campo di immissione di testo, ad esempio un utente aggiunge o elimina testo.

Se devi raccogliere dati definiti e standardizzati dagli utenti, utilizza questo widget SelectionInput. Per raccogliere dati definiti dagli utenti, utilizza invece il widget TextInput.

Le app di chat ricevono e possono elaborare il valore degli elementi selezionati durante gli eventi di input del modulo. Per informazioni dettagliate sull'utilizzo degli input del modulo, consulta Ricevere i dati del modulo.

Supportato solo dalle dialoghi. A breve saranno supportati i messaggi relativi alle carte.

Esempio

La seguente immagine mostra una scheda composta da un widget SelectionInput.

Una finestra di dialogo con un widget di selezione.
Figura 1: una finestra di dialogo chiede all'utente di specificare se un contatto è professionale o personale con un widget SelectionInput.

Ecco il codice JSON della scheda:

JSON

{
  "cardsV2": [
    {
      "cardId": "exampleCard",
      "card": {
        "sections": [
          {
            "header": "Add new contact",
            "widgets": [
              {
                "textInput": {
                  "label": "Notes",
                  "type": "MULTIPLE_LINE",
                  "name": "notes"
                }
              },
              {
                "selectionInput": {
                  "type": "RADIO_BUTTON",
                  "label": "Contact type",
                  "name": "contactType",
                  "items": [
                    {
                      "text": "Work",
                      "value": "Work",
                      "selected": false
                    },
                    {
                      "text": "Personal",
                      "value": "Personal",
                      "selected": false
                    }
                  ]
                }
              },
              {
                "buttonList": {
                  "buttons": [
                    {
                      "text": "Submit",
                      "onClick": {
                        "action": {
                          "function": "confirmDialogSuccess",
                          "parameters": [
                            {
                              "key": "confirmDialogSuccess",
                              "value": "confirmDialogSuccess"
                            }
                          ]
                        }
                      }
                    }
                  ]
                },
                "horizontalAlignment": "END"
              }
            ]
          }
        ]
      }
    }
  ]
}

SelectionInput Rappresentazione e campi JSON

Rappresentazione JSON
{
  "name": string,
  "label": string,
  "type": enum (SelectionType),
  "items": [
    {
      object (SelectionItem)
    }
  ],
  "onChangeAction": {
    object (Action)
  }
}
Campi
name

string

Il nome con cui viene identificato l'input di selezione in un evento di input del modulo.

Per maggiori dettagli sull'utilizzo degli input del modulo, consulta Ricevere i dati del modulo .

label

string

Il testo visualizzato sopra il campo di immissione della selezione nell'interfaccia utente.

Specifica del testo che aiuti l'utente a inserire le informazioni di cui la tua app ha bisogno. Ad esempio, se gli utenti selezionano l'urgenza di un ticket di lavoro da un menu a discesa, l'etichetta potrebbe essere "Urgenza" o "Seleziona urgenza".

type

enum ( SelectionType )

Il modo in cui un'opzione viene mostrata agli utenti. Opzioni diverse supportano tipi diversi di interazioni. Ad esempio, gli utenti possono attivare più caselle di controllo, ma possono selezionare un solo valore da un menu a discesa.

Ogni input di selezione supporta un tipo di selezione. La combinazione di caselle di controllo e sensori, ad esempio, non è supportata.

items[]

object ( SelectionItem )

Un array degli elementi selezionati. ad esempio tutte le caselle di controllo selezionate.

onChangeAction

object ( Action )

Se specificato, il modulo viene inviato quando la selezione cambia. Se non viene specificato, devi specificare un pulsante separato che invia il modulo.

Per maggiori dettagli sull'utilizzo degli input del modulo, consulta Ricevere i dati del modulo .

SelectionType valori enumerati

Enum
CHECK_BOX

Un insieme di caselle di controllo. Gli utenti possono selezionare più caselle di controllo per ogni selezione.

Al momento funzione supportata nelle finestre di dialogo . Il supporto per i messaggi delle schede sarà disponibile a breve.

RADIO_BUTTON

Un insieme di pulsanti di opzione. Gli utenti possono selezionare un pulsante di opzione per ogni selezione.

Al momento funzione supportata nelle finestre di dialogo . Il supporto per i messaggi delle schede sarà disponibile a breve.

SWITCH

Un set di sensori. Gli utenti possono attivare più sensori contemporaneamente per ogni selezione.

Al momento funzione supportata nelle finestre di dialogo . Il supporto per i messaggi delle schede sarà disponibile a breve.

DROPDOWN

Un menu a discesa. Gli utenti possono selezionare una voce di menu a discesa per input di selezione.

Al momento funzione supportata nelle finestre di dialogo . Il supporto per i messaggi delle schede sarà disponibile a breve.

SelectionItem Rappresentazione e campi JSON

Rappresentazione JSON
{
  "text": string,
  "value": string,
  "selected": boolean
}
Campi
text

string

Il testo mostrato agli utenti.

value

string

Il valore associato a questo elemento. Il client deve utilizzare questo valore come valore di input del modulo.

Per maggiori dettagli sull'utilizzo degli input del modulo, consulta Ricevere i dati del modulo .

selected

boolean

Quando true , è selezionato più di un elemento. Se vengono selezionati più elementi per i pulsanti di opzione e i menu a discesa, viene ricevuto il primo elemento selezionato e quelli successivi vengono ignorati.