Un widget del campo di immissione che accetta l'inserimento di testo.
Disponibile per i componenti aggiuntivi di Google Workspace e le app Google Chat.
var textInput = CardService.newTextInput() .setFieldName("text_input_form_input_key") .setTitle("Text input title") .setHint("Text input hint");
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
setFieldName(fieldName) | TextInput | Imposta la chiave che identifica questo input di testo nell'oggetto evento che viene generato quando sono è un'interazione con l'interfaccia utente. |
setHint(hint) | TextInput | Consente di impostare un suggerimento per l'input di testo. |
setMultiline(multiline) | TextInput | Consente di impostare se il testo di input viene visualizzato su una o più righe. |
setOnChangeAction(action) | TextInput | Imposta un'azione da eseguire ogni volta che l'input di testo cambia. |
setSuggestions(suggestions) | TextInput | Imposta i suggerimenti per il completamento automatico nel campo di testo. |
setSuggestionsAction(suggestionsAction) | TextInput | Imposta l'azione di callback per recuperare i suggerimenti in base all'input dell'utente per il completamento automatico. |
setTitle(title) | TextInput | Imposta il titolo da visualizzare sopra il campo di immissione. |
setValue(value) | TextInput | Consente di impostare il valore precompilato da impostare nel campo di immissione. |
Documentazione dettagliata
setFieldName(fieldName)
Imposta la chiave che identifica questo input di testo nell'oggetto evento che viene generato quando sono è un'interazione con l'interfaccia utente. Non visibile all'utente. Obbligatorio, deve essere univoco.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fieldName | String | La chiave utilizzata per identificare questo input. |
Invio
TextInput
: oggetto per il collegamento.
setHint(hint)
Consente di impostare un suggerimento per l'input di testo. Utilizzato per offrire all'utente ulteriori indicazioni su cosa inserire. Per Ad esempio, un suggerimento potrebbe descrivere la formattazione ("xxx-xxx-xxxx") per un campo del numero di telefono.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
hint | String | Il suggerimento di testo da visualizzare sotto il campo di immissione. Questo testo è sempre visibile. |
Invio
TextInput
: oggetto per il collegamento.
setMultiline(multiline)
Consente di impostare se il testo di input viene visualizzato su una o più righe.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
multiline | Boolean | L'impostazione multilinea. |
Invio
TextInput
: oggetto per il collegamento.
setOnChangeAction(action)
setSuggestions(suggestions)
Imposta i suggerimenti per il completamento automatico nel campo di testo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
suggestions | Suggestions | La raccolta di suggerimenti da utilizzare. |
Invio
TextInput
: oggetto per il collegamento.
setSuggestionsAction(suggestionsAction)
Imposta l'azione di callback per recuperare i suggerimenti in base all'input dell'utente per il completamento automatico. La
Il parametro Action
deve specificare una funzione di callback che restituisca un oggetto SuggestionsResponse
.
var action = CardService.newAction() .setFunctionName('suggestionCallback') .setParameters({'numSuggestions': 3}); CardService.newTextInput() .setFieldName('option-field') .setTitle('Option Selected') .setSuggestionsAction(action); // ... function suggestionCallback(e) { var suggestions = CardService.newSuggestions(); var numSuggestions = parseInt(e.parameter['numSuggestions']); for(var i = 1; i <= numSuggestions; i++) { suggestions.addSuggestion('Suggestion ' + i); } return CardService.newSuggestionsResponseBuilder() .setSuggestions(suggestions) .build(); }
Parametri
Nome | Tipo | Descrizione |
---|---|---|
suggestionsAction | Action | L'azione che recupera i suggerimenti per questo input. |
Invio
TextInput
: oggetto per il collegamento.
setTitle(title)
Imposta il titolo da visualizzare sopra il campo di immissione. Obbligatorio.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
title | String | L'etichetta di testo per questo input. |
Invio
TextInput
: oggetto per il collegamento.
setValue(value)
Consente di impostare il valore precompilato da impostare nel campo di immissione.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | String | Il valore predefinito inserito nell'input. È sempre rappresentato come una stringa nel e i parametri di callback del modulo. |
Invio
TextInput
: oggetto per il collegamento.