Class TextInput

Entrada detexto

Um widget de campo de entrada que aceita entrada de texto.

Suporte à validação do envio de formulários. Quando Action.setAllWidgetsAreRequired(allWidgetsAreRequired) é definido como true ou quando esse widget é especificado por Action.addRequiredWidget(requiredWidget), a ação de envio é bloqueada, a menos que um valor seja inserido.

Disponível para complementos do Google Workspace e apps do Google Chat. 

const textInput = CardService.newTextInput()
                      .setFieldName('text_input_form_input_key')
                      .setTitle('Text input title')
                      .setHint('Text input hint');

Métodos

MétodoTipo de retornoBreve descrição
setFieldName(fieldName)TextInputDefine a chave que identifica essa entrada de texto no objeto de evento gerado quando há uma interação com a interface.
setHint(hint)TextInputDefine uma dica para a entrada de texto.
setMultiline(multiline)TextInputDefine se o texto de entrada aparece em uma ou várias linhas.
setOnChangeAction(action)TextInputDefine uma ação a ser realizada sempre que a entrada de texto mudar.
setSuggestions(suggestions)TextInputDefine as sugestões de preenchimento automático no campo de texto.
setSuggestionsAction(suggestionsAction)TextInputDefine a ação de callback para buscar sugestões com base na entrada do usuário para preenchimento automático.
setTitle(title)TextInputDefine o título que será mostrado acima do campo de entrada.
setValidation(validation)TextInputDefine a regra de validação para este widget.
setValue(value)TextInputDefine o valor preenchido previamente a ser definido no campo de entrada.

Documentação detalhada

setFieldName(fieldName)

Define a chave que identifica essa entrada de texto no objeto de evento gerado quando há uma interação com a interface. Não aparece para o usuário. Obrigatório, precisa ser exclusivo.

Parâmetros

NomeTipoDescrição
fieldNameStringA chave usada para identificar essa entrada.

Retornar

TextInput: este objeto, para encadeamento.

setHint(hint)

Define uma dica para a entrada de texto. Usado para dar ao usuário orientações extras sobre o que inserir. Por exemplo, uma dica pode descrever a formatação ("xxx-xxx-xxxx") para um campo de número de telefone.

Parâmetros

NomeTipoDescrição
hintStringA dica de texto que será exibida abaixo do campo de entrada. Esse texto está sempre visível.

Retornar

TextInput: este objeto, para encadeamento.

setMultiline(multiline)

Define se o texto de entrada aparece em uma ou várias linhas.

Parâmetros

NomeTipoDescrição
multilineBooleanA configuração de várias linhas.

Retornar

TextInput: este objeto, para encadeamento.

setOnChangeAction(action)

Define uma ação a ser realizada sempre que a entrada de texto mudar.

Parâmetros

NomeTipoDescrição
actionActionA ação a ser tomada.

Retornar

TextInput: este objeto, para encadeamento.

setSuggestions(suggestions)

Define as sugestões de preenchimento automático no campo de texto.

Parâmetros

NomeTipoDescrição
suggestionsSuggestionsA coleção de sugestões a serem usadas.

Retornar

TextInput: este objeto, para encadeamento.

setSuggestionsAction(suggestionsAction)

Define a ação de callback para buscar sugestões com base na entrada do usuário para preenchimento automático. O parâmetro Action precisa especificar uma função de callback que retorne um objeto SuggestionsResponse. 

const action = CardService.newAction()
                   .setFunctionName('suggestionCallback')
                   .setParameters({numSuggestions: 3});

CardService.newTextInput()
    .setFieldName('option-field')
    .setTitle('Option Selected')
    .setSuggestionsAction(action);

// ...

function suggestionCallback(e) {
  const suggestions = CardService.newSuggestions();
  const numSuggestions = Number.parseInt(e.parameter.numSuggestions);
  for (let i = 1; i <= numSuggestions; i++) {
    suggestions.addSuggestion(`Suggestion ${i}`);
  }
  return CardService.newSuggestionsResponseBuilder()
      .setSuggestions(suggestions)
      .build();
}

Parâmetros

NomeTipoDescrição
suggestionsActionActionA ação que busca sugestões para essa entrada.

Retornar

TextInput: este objeto, para encadeamento.

setTitle(title)

Define o título que será mostrado acima do campo de entrada. Obrigatório.

Parâmetros

NomeTipoDescrição
titleStringEtiqueta de texto para essa entrada.

Retornar

TextInput: este objeto, para encadeamento.

setValidation(validation)

Define a regra de validação para este widget. 

const validation = CardService.newValidation().setCharacterLimit('10').setType(
    CardService.InputType.TEXT);

const input = CardService.newTextInput()
                  .setFieldName('text_name_xxx1')
                  .setTitle('Max 10 characters')
                  .setValidation(validation);

Parâmetros

NomeTipoDescrição
validationValidationA regra de validação para este widget TextInput.

Retornar

TextInput: este objeto, para encadeamento.

setValue(value)

Define o valor preenchido previamente a ser definido no campo de entrada.

Parâmetros

NomeTipoDescrição
valueStringO valor padrão colocado na entrada. Ele é sempre representado como uma string nos parâmetros de callback do formulário.

Retornar

TextInput: este objeto, para encadeamento.