テキスト入力を受け入れる入力フィールド ウィジェット。
フォーム送信の検証をサポートします。Action.setAllWidgetsAreRequired(allWidgetsAreRequired) が true に設定されている場合、またはこのウィジェットが Action.addRequiredWidget(requiredWidget) で指定されている場合、値が入力されない限り、送信アクションはブロックされます。
Google Workspace アドオンと Google Chat アプリで利用できます。
const textInput = CardService.newTextInput() .setFieldName('text_input_form_input_key') .setTitle('Text input title') .setHint('Text input hint');
メソッド
| メソッド | 戻り値の型 | 概要 |
|---|---|---|
set | Text | UI 操作が発生したときに生成されるイベント オブジェクトで、このテキスト入力を識別するキーを設定します。 |
set | Text | テキスト入力のヒントを設定します。 |
set | Text | 入力テキストを 1 行または複数行で表示するかどうかを設定します。 |
set | Text | テキスト入力が変更されるたびに実行されるアクションを設定します。 |
set | Text | テキスト フィールドに予測入力の候補を設定します。 |
set | Text | 自動入力のためにユーザー入力に基づいて候補を取得するコールバック アクションを設定します。 |
set | Text | 入力フィールドの上に表示されるタイトルを設定します。 |
set | Text | このウィジェットの検証ルールを設定します。 |
set | Text | 入力フィールドに設定する事前入力値を設定します。 |
詳細なドキュメント
set
UI 操作が発生したときに生成されるイベント オブジェクトで、このテキスト入力を識別するキーを設定します。ユーザーには表示されません。必須で、一意である必要があります。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
field | String | この入力を識別するために使用されるキー。 |
戻る
Text - チェーン用のこのオブジェクト。
set
テキスト入力のヒントを設定します。入力内容についてユーザーに追加のガイダンスを提供するために使用されます。たとえば、ヒントでは電話番号フィールドの形式（「xxx-xxx-xxxx」）を説明できます。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
hint | String | 入力フィールドの下に表示するテキスト ヒント。このテキストは常に表示されます。 |
戻る
Text - チェーン用のこのオブジェクト。
set
入力テキストを 1 行に表示するか複数行に表示するかを設定します。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
multiline | Boolean | 複数行の設定。 |
戻る
Text - チェーン用のこのオブジェクト。
set
set
テキスト フィールドに予測入力の候補を設定します。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
suggestions | Suggestions | 使用する候補のコレクション。 |
戻る
Text - チェーン用のこのオブジェクト。
set
ユーザー入力に基づいて候補を取得し、自動入力を行うコールバック アクションを設定します。Action パラメータには、Suggestions オブジェクトを返すコールバック関数を指定する必要があります。
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(); }
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
suggestions | Action | この入力の候補を取得するアクション。 |
戻る
Text - チェーン用のこのオブジェクト。
set
set
このウィジェットの検証ルールを設定します。
const validation = CardService.newValidation().setCharacterLimit('10').setType( CardService.InputType.TEXT); const input = CardService.newTextInput() .setFieldName('text_name_xxx1') .setTitle('Max 10 characters') .setValidation(validation);
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
validation | Validation | この Text ウィジェットの検証ルール。 |
戻る
Text - チェーン用のこのオブジェクト。
set
入力フィールドに設定する事前入力値を設定します。
パラメータ
| 名前 | 型 | 説明 |
|---|---|---|
value | String | 入力に配置されたデフォルト値。フォームのコールバック パラメータでは常に文字列として表されます。 |
戻る
Text - チェーン用のこのオブジェクト。