A input field widget that accepts text input.
Available for Google Workspace Add-ons and Google Chat apps.
var textInput = CardService.newTextInput() .setFieldName("text_input_form_input_key") .setTitle("Text input title") .setHint("Text input hint");
Methods
Method | Return type | Brief description |
---|---|---|
setFieldName(fieldName) | TextInput | Sets the key that identifies this text input in the event object that is generated when there is a UI interaction. |
setHint(hint) | TextInput | Sets a hint for the text input. |
setMultiline(multiline) | TextInput | Sets whether the input text shows on one line or multiple lines. |
setOnChangeAction(action) | TextInput | Sets an action to be performed whenever the text input changes. |
setSuggestions(suggestions) | TextInput | Sets the suggestions for autocompletion in the text field. |
setSuggestionsAction(suggestionsAction) | TextInput | Sets the callback action to fetch suggestions based on user input for autocompletion. |
setTitle(title) | TextInput | Sets the title to be shown above the input field. |
setValue(value) | TextInput | Sets the pre-filled value to be set in the input field. |
Detailed documentation
setFieldName(fieldName)
Sets the key that identifies this text input in the event object that is generated when there is a UI interaction. Not visible to the user. Required, must be unique.
Parameters
Name | Type | Description |
---|---|---|
fieldName | String | The key that is used to identify this input. |
Return
TextInput
— This object, for chaining.
setHint(hint)
Sets a hint for the text input. Used to give the user extra guidance on what to input. For example, a hint could describe formatting ("xxx-xxx-xxxx") for a phone number field.
Parameters
Name | Type | Description |
---|---|---|
hint | String | The text hint to display below the input field. This text is always visible. |
Return
TextInput
— This object, for chaining.
setMultiline(multiline)
Sets whether the input text shows on one line or multiple lines.
Parameters
Name | Type | Description |
---|---|---|
multiline | Boolean | The multiline setting. |
Return
TextInput
— This object, for chaining.
setOnChangeAction(action)
setSuggestions(suggestions)
Sets the suggestions for autocompletion in the text field.
Parameters
Name | Type | Description |
---|---|---|
suggestions | Suggestions | The collection of suggestions to use. |
Return
TextInput
— This object, for chaining.
setSuggestionsAction(suggestionsAction)
Sets the callback action to fetch suggestions based on user input for autocompletion. The
Action
parameter must specify a callback function that returns a SuggestionsResponse
object.
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(); }
Parameters
Name | Type | Description |
---|---|---|
suggestionsAction | Action | The action that fetches suggestions for this input. |
Return
TextInput
— This object, for chaining.
setTitle(title)
Sets the title to be shown above the input field. Required.
Parameters
Name | Type | Description |
---|---|---|
title | String | The text label for this input. |
Return
TextInput
— This object, for chaining.
setValue(value)
Sets the pre-filled value to be set in the input field.
Parameters
Name | Type | Description |
---|---|---|
value | String | The default value placed in the input. It is always represented as a string in the form callback parameters. |
Return
TextInput
— This object, for chaining.