一个接受文本输入的输入字段微件。
var textInput = CardService.newTextInput() .setFieldName("text_input_form_input_key") .setTitle("Text input title") .setHint("Text input hint");
方法
方法 | 返回类型 | 简介 |
---|---|---|
setFieldName(fieldName) | TextInput | 设置用于在发生界面互动时生成的事件对象中标识此文本输入的键。 |
setHint(hint) | TextInput | 设置文本输入提示。 |
setMultiline(multiline) | TextInput | 设置输入文本是显示在一行还是多行。 |
setOnChangeAction(action) | TextInput | 设置每当文本输入发生更改时要执行的操作。 |
setSuggestions(suggestions) | TextInput | 设置文本字段中的自动填充建议。 |
setSuggestionsAction(suggestionsAction) | TextInput | 设置回调操作,以根据用户输入来提取建议以完成操作。 |
setTitle(title) | TextInput | 设置要在输入字段上方显示的标题。 |
setValue(value) | TextInput | 设置要在输入字段中设置的预填充值。 |
详细文档
setFieldName(fieldName)
设置用于在发生界面互动时生成的事件对象中标识此文本输入的键。不会向用户显示。必需且必须是唯一的。
参数
名称 | 类型 | 说明 |
---|---|---|
fieldName | String | 用于标识此输入的键。 |
返回
TextInput
- 此对象,用于实现链式连接。
setHint(hint)
设置文本输入提示。用于为用户提供额外的输入指导。例如,一条提示可以描述电话号码字段的格式 (“qu-xxx-xxx-xxxx”)。
参数
名称 | 类型 | 说明 |
---|---|---|
hint | String | 输入为空时显示的文本提示。 |
返回
TextInput
- 此对象,用于实现链式连接。
setMultiline(multiline)
setOnChangeAction(action)
setSuggestions(suggestions)
setSuggestionsAction(suggestionsAction)
设置回调操作,以根据用户输入来提取建议以完成操作。Action
参数必须指定可返回 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(); }
参数
名称 | 类型 | 说明 |
---|---|---|
suggestionsAction | Action | 提取此输入建议的操作。 |
返回
TextInput
- 此对象,用于实现链式连接。