Questa pagina è stata tradotta dall'API Cloud Translation.

Class 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

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)`

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

Parametri

Nome	Tipo	Descrizione
`action`	`Action`	L'azione da intraprendere.

Invio

TextInput: oggetto per il collegamento.

`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.