텍스트 입력을 허용하는 입력란 위젯
Google Workspace 부가기능 및 Google Chat 앱에서 사용할 수 있습니다.
var textInput = CardService.newTextInput() .setFieldName("text_input_form_input_key") .setTitle("Text input title") .setHint("Text input hint");
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
setFieldName(fieldName) | TextInput | 텍스트 입력이 있을 때 생성되는 이벤트 객체에서 이 텍스트 입력을 식별하는 키를 설정합니다. UI 상호작용입니다. |
setHint(hint) | TextInput | 텍스트 입력에 대한 힌트를 설정합니다. |
setMultiline(multiline) | TextInput | 입력 텍스트를 한 줄에 표시할지 아니면 여러 줄에 표시할지 설정합니다. |
setOnChangeAction(action) | TextInput | 텍스트 입력이 변경될 때마다 실행할 작업을 설정합니다. |
setSuggestions(suggestions) | TextInput | 텍스트 필드에 자동 완성 제안을 설정합니다. |
setSuggestionsAction(suggestionsAction) | TextInput | 자동 완성을 위한 사용자 입력을 기반으로 추천을 가져오도록 콜백 작업을 설정합니다. |
setTitle(title) | TextInput | 입력란 위에 표시할 제목을 설정합니다. |
setValue(value) | TextInput | 입력란에 설정할 미리 채워진 값을 설정합니다. |
자세한 문서
setFieldName(fieldName)
텍스트 입력이 있을 때 생성되는 이벤트 객체에서 이 텍스트 입력을 식별하는 키를 설정합니다. UI 상호작용입니다. 사용자에게 표시되지 않습니다. 필수 항목이며 고유해야 합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
fieldName | String | 이 입력을 식별하는 데 사용되는 키입니다. |
리턴
TextInput
- 체이닝을 위한 객체입니다.
setHint(hint)
텍스트 입력에 대한 힌트를 설정합니다. 사용자에게 입력할 내용에 관한 추가 안내를 제공하는 데 사용됩니다. 대상 예를 들어 힌트는 전화번호 입력란의 형식("xxx-xxx-xxxx")을 설명할 수 있습니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
hint | String | 입력란 아래에 표시할 텍스트 힌트입니다. 이 텍스트는 항상 표시됩니다. |
리턴
TextInput
- 체이닝을 위한 객체입니다.
setMultiline(multiline)
입력 텍스트를 한 줄에 표시할지 아니면 여러 줄에 표시할지 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
multiline | Boolean | 여러 줄 설정입니다. |
리턴
TextInput
- 체이닝을 위한 객체입니다.
setOnChangeAction(action)
setSuggestions(suggestions)
텍스트 필드에 자동 완성 제안을 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
suggestions | Suggestions | 사용할 추천 컬렉션입니다. |
리턴
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(); }
매개변수
이름 | 유형 | 설명 |
---|---|---|
suggestionsAction | Action | 이 입력에 대한 추천을 가져오는 작업입니다. |
리턴
TextInput
- 체이닝을 위한 객체입니다.
setTitle(title)
입력란 위에 표시할 제목을 설정합니다. 필수 항목입니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
title | String | 이 입력의 텍스트 라벨입니다. |
리턴
TextInput
- 체이닝을 위한 객체입니다.
setValue(value)
입력란에 설정할 미리 채워진 값을 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
value | String | 입력에 입력된 기본값입니다. 항상 양식 콜백 매개변수를 만듭니다. |
리턴
TextInput
- 체이닝을 위한 객체입니다.