Class TextInput

TextInput

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

MetodoTipo restituitoBreve descrizione
setFieldName(fieldName)TextInputImposta la chiave che identifica questo input di testo nell'oggetto evento che viene generato quando sono è un'interazione con l'interfaccia utente.
setHint(hint)TextInputConsente di impostare un suggerimento per l'input di testo.
setMultiline(multiline)TextInputConsente di impostare se il testo di input viene visualizzato su una o più righe.
setOnChangeAction(action)TextInputImposta un'azione da eseguire ogni volta che l'input di testo cambia.
setSuggestions(suggestions)TextInputImposta i suggerimenti per il completamento automatico nel campo di testo.
setSuggestionsAction(suggestionsAction)TextInputImposta l'azione di callback per recuperare i suggerimenti in base all'input dell'utente per il completamento automatico.
setTitle(title)TextInputImposta il titolo da visualizzare sopra il campo di immissione.
setValue(value)TextInputConsente 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

NomeTipoDescrizione
fieldNameStringLa 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

NomeTipoDescrizione
hintStringIl 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

NomeTipoDescrizione
multilineBooleanL'impostazione multilinea.

Invio

TextInput: oggetto per il collegamento.


setOnChangeAction(action)

Imposta un'azione da eseguire ogni volta che l'input di testo cambia.

Parametri

NomeTipoDescrizione
actionActionL'azione da intraprendere.

Invio

TextInput: oggetto per il collegamento.


setSuggestions(suggestions)

Imposta i suggerimenti per il completamento automatico nel campo di testo.

Parametri

NomeTipoDescrizione
suggestionsSuggestionsLa 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

NomeTipoDescrizione
suggestionsActionActionL'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

NomeTipoDescrizione
titleStringL'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

NomeTipoDescrizione
valueStringIl valore predefinito inserito nell'input. È sempre rappresentato come una stringa nel e i parametri di callback del modulo.

Invio

TextInput: oggetto per il collegamento.