Class TextInput

TextInput

텍스트 입력을 허용하는 입력란 위젯입니다.

Google Workspace 부가기능 및 Google Chat 앱에서 사용할 수 있습니다.

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

방법

메서드반환 유형간략한 설명
setFieldName(fieldName)TextInputUI 상호작용이 있을 때 생성되는 이벤트 객체에서 이 텍스트 입력을 식별하는 키를 설정합니다.
setHint(hint)TextInput텍스트 입력에 대한 힌트를 설정합니다.
setMultiline(multiline)TextInput입력 텍스트를 한 줄에 표시할지 아니면 여러 줄에 표시할지 설정합니다.
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)

입력 텍스트를 한 줄에 표시할지 아니면 여러 줄에 표시할지 설정합니다.

매개변수

이름유형설명
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: 체이닝용 객체입니다.