TextInput

Il widget TextInput fornisce un campo in cui gli utenti possono inserire testo. 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 astratti o sconosciuti dagli utenti, utilizza questo widget TextInput. Per raccogliere dati definiti dagli utenti, utilizza invece il widget SelectionInput.

Le app di chat ricevono e possono elaborare il valore del testo inserito durante gli eventi di inserimento 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 TextInput.

Una finestra di dialogo con vari widget.
Figura 1: una finestra di dialogo che consente a un utente di creare un nuovo contatto per la propria rubrica. I campi nome e indirizzo sono TextInput widget.

Ecco il codice JSON della scheda:

JSON

{
  "cardsV2": [
    {
      "cardId": "exampleCard",
      "card": {
        "sections": [
          {
            "header": "Add new contact",
            "widgets": [
              {
                "textInput": {
                  "label": "Name",
                  "type": "SINGLE_LINE",
                  "name": "contactName"
                }
              },
              {
                "textInput": {
                  "label": "Address",
                  "type": "MULTIPLE_LINE",
                  "name": "address"
                }
              },
              {
                "decoratedText": {
                  "text": "Add to favorites",
                  "switchControl": {
                    "controlType": "SWITCH",
                    "name": "saveFavorite"
                  }
                }
              },
              {
                "decoratedText": {
                  "text": "Merge with existing contacts",
                  "switchControl": {
                    "controlType": "SWITCH",
                    "name": "mergeContact",
                    "selected": true
                  }
                }
              },
              {
                "buttonList": {
                  "buttons": [
                    {
                      "text": "Next",
                      "onClick": {
                        "action": {
                          "function": "openSequentialDialog"
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

TextInput Rappresentazione e campi JSON

Rappresentazione JSON
{
  "name": string,
  "label": string,
  "hintText": string,
  "value": string,
  "type": enum (Type),
  "onChangeAction": {
    object (Action)
  },
  "initialSuggestions": {
    object (Suggestions)
  },
  "autoCompleteAction": {
    object (Action)
  }
}
Campi
name

string

Il nome con cui l'input di testo viene identificato 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 del testo nell'interfaccia utente.

Specifica del testo che aiuti l'utente a inserire le informazioni di cui la tua app ha bisogno. Ad esempio, se chiedi il nome di una persona, ma in particolare hai bisogno del suo cognome, scrivi "cognome" invece di "nome".

Obbligatorio se hintText non è specificato. In caso contrario, facoltativo.

hintText

string

Testo visualizzato sotto il campo di immissione del testo che ha lo scopo di assistere gli utenti chiedendo loro di inserire un determinato valore. Questo testo è sempre visibile.

Obbligatorio se label non è specificato. In caso contrario, facoltativo.

value

string

Il valore inserito da un utente, restituito come parte di un evento di input del modulo.

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

type

enum ( Type )

Come viene visualizzato un campo di immissione di testo nell'interfaccia utente. Ad esempio, indica se il campo è di una sola riga o di più righe.

onChangeAction

object ( Action )

Che cosa fare quando si verifica un cambiamento nel campo di immissione del testo.

Alcuni esempi di modifiche sono l'aggiunta di un utente al campo o l'eliminazione di testo.

Alcuni esempi di azioni da eseguire includono l'esecuzione di una funzione personalizzata o l'apertura di una finestra di dialogo in Google Chat.

initialSuggestions

object ( Suggestions )

Valori suggeriti che gli utenti possono inserire. Questi valori vengono visualizzati quando gli utenti fanno clic nel campo di immissione del testo. Durante la digitazione, i valori suggeriti filtrano dinamicamente in base a ciò che gli utenti hanno digitato.

Ad esempio, un campo di immissione di testo per il linguaggio di programmazione potrebbe suggerire Java, JavaScript, Python e C++. Quando gli utenti iniziano a digitare "Jav", l'elenco di suggerimenti filtra per mostrare solo Java e JavaScript.

I valori suggeriti aiutano gli utenti a inserire i valori che la tua app può avere. Alcuni utenti potrebbero fare riferimento a JavaScript, ad esempio "javascript" e ad altri "script java". Suggerire "JavaScript" può standardizzare il modo in cui gli utenti interagiscono con la tua app.

Se specificato, TextInput.type è sempre SINGLE_LINE , anche se è impostato su MULTIPLE_LINE .

autoCompleteAction

object ( Action )

(Facoltativo) Specifica l'azione da eseguire quando il campo di immissione del testo fornisce suggerimenti agli utenti che vi interagiscono.

Se non sono specificati, i suggerimenti sono impostati da initialSuggestions e vengono elaborati dal client.

Se specificata, l'app esegue l'azione specificata qui, ad esempio l'esecuzione di una funzione personalizzata.

Supportato dai componenti aggiuntivi di Google Workspace, ma non dalle app di chat. Il supporto per le app di chat sarà disponibile a breve.

Suggestions Rappresentazione e campi JSON

Rappresentazione JSON
{
  "items": [
    {
      object (SuggestionItem)
    }
  ]
}
Campi
items[]

object ( SuggestionItem )

Un elenco di suggerimenti utilizzati per il completamento automatico dei consigli nei campi di immissione del testo.

SuggestionItem Rappresentazione e campi JSON

Rappresentazione JSON
{

  // Union field content can be only one of the following:
  "text": string
  // End of list of possible types for union field content.
}
Campi

Campo Union content .

content può essere solo uno dei seguenti:

text

string

Il valore di un input suggerito per un campo di immissione di testo. Equivale a ciò che gli utenti inseriscono.