Class TextInput

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。
TextInput

テキスト入力を受け入れる入力フィールド ウィジェット。

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

Methods

方法戻り値の型概要
setFieldName(fieldName)TextInputUI 操作が発生したときに生成されるイベント オブジェクトで、このテキスト入力を識別するキーを設定します。
setHint(hint)TextInputテキスト入力のヒントを設定します。
setMultiline(multiline)TextInput入力テキストを 1 行で表示するか、複数行に表示するかを設定します。
setOnChangeAction(action)TextInputテキスト入力が変更されるたびに実行するアクションを設定します。
setSuggestions(suggestions)TextInputテキスト フィールドにオートコンプリートの候補を設定します。
setSuggestionsAction(suggestionsAction)TextInputオートコンプリートに対するユーザー入力に基づいて候補を取得するコールバック アクションを設定します。
setTitle(title)TextInput入力フィールドの上に表示するタイトルを設定します。
setValue(value)TextInput入力フィールドに事前入力する値を設定します。

詳細なドキュメント

setFieldName(fieldName)

UI 操作が発生したときに生成されるイベント オブジェクトで、このテキスト入力を識別するキーを設定します。ユーザーには表示されません。必須です。一意にする必要があります。

パラメータ

名前説明
fieldNameStringこの入力の識別に使用されるキー。

戻る

TextInput - チェーン用のオブジェクト。


setHint(hint)

テキスト入力のヒントを設定します。入力に関してユーザーに追加のガイダンスを提供するために使用されます。たとえば、ヒントでは電話番号フィールドの形式("xxx-xxx-xxxx")を記述します。

パラメータ

名前説明
hintString入力が空の場合に表示されるテキストのヒント。

戻る

TextInput - チェーン用のオブジェクト。


setMultiline(multiline)

入力テキストを 1 行で表示するか、複数行に表示するかを設定します。

パラメータ

名前説明
multilineBoolean複数行の設定。

戻る

TextInput - チェーン用のオブジェクト。


setOnChangeAction(action)

テキスト入力が変更されるたびに実行するアクションを設定します。

パラメータ

名前説明
actionAction実行する操作。

戻る

TextInput - チェーン用のオブジェクト。


setSuggestions(suggestions)

テキスト フィールドにオートコンプリートの候補を設定します。

パラメータ

名前説明
suggestionsSuggestions使用する候補のコレクション。

戻る

TextInput - チェーン用のオブジェクト。


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();
}

パラメータ

名前説明
suggestionsActionActionこの入力の提案を取得するアクション。

戻る

TextInput - チェーン用のオブジェクト。


setTitle(title)

入力フィールドの上に表示するタイトルを設定します。必須。

パラメータ

名前説明
titleStringこの入力のテキストラベル。

戻る

TextInput - チェーン用のオブジェクト。


setValue(value)

入力フィールドに事前入力する値を設定します。

パラメータ

名前説明
valueString入力対象のデフォルト値。フォーム コールバック パラメータでは常に文字列として表されます。

戻る

TextInput - チェーン用のオブジェクト。