텍스트 입력을 허용하는 입력란 위젯입니다.
양식 제출 유효성 검사를 지원합니다. 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');
메서드
| 메서드 | 반환 유형 | 간략한 설명 |
|---|---|---|
add | Widget | 위젯에서 실행할 수 있는 이벤트 작업을 추가합니다. |
set | Text | UI 상호작용이 있을 때 생성되는 이벤트 객체에서 이 텍스트 입력을 식별하는 키를 설정합니다. |
set | Text | 텍스트 입력의 힌트를 설정합니다. |
set | Text | Google Workspace 애플리케이션의 데이터 소스를 설정합니다. |
set | Widget | 변형할 위젯을 식별하는 데 사용되는 할당된 고유 ID를 설정합니다. |
set | Text | 이 텍스트 입력란이 변수 삽입을 지원하는지 여부를 설정합니다. |
set | Text | 입력 텍스트가 한 줄로 표시되는지 여러 줄로 표시되는지 설정합니다. |
set | Text | 텍스트 입력이 변경될 때마다 실행할 작업을 설정합니다. |
set | Text | 텍스트 필드의 자동 완성 추천을 설정합니다. |
set | Text | 자동 완성의 사용자 입력을 기반으로 추천을 가져오는 콜백 작업을 설정합니다. |
set | Text | 입력란 위에 표시할 제목을 설정합니다. |
set | Text | 이 위젯의 유효성 검사 규칙을 설정합니다. |
set | Text | 입력 필드에 설정할 사전 입력된 값을 설정합니다. |
set | Widget | 위젯의 공개 상태를 설정합니다. |
자세한 문서
add
위젯에서 실행할 수 있는 이벤트 작업을 추가합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
event | Event | 추가할 Event입니다. |
리턴
Widget - 연결을 위한 객체입니다.
set
UI 상호작용이 있을 때 생성되는 이벤트 객체에서 이 텍스트 입력을 식별하는 키를 설정합니다. 사용자에게 표시되지 않습니다. 필수사항이며 고유해야 합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
field | String | 이 입력을 식별하는 데 사용되는 키입니다. |
리턴
Text - 연결을 위한 이 객체
set
텍스트 입력의 힌트를 설정합니다. 사용자에게 입력할 내용에 관한 추가 안내를 제공하는 데 사용됩니다. 예를 들어 힌트는 전화번호 필드의 서식 ('xxx-xxx-xxxx')을 설명할 수 있습니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
hint | String | 입력 필드 아래에 표시할 텍스트 힌트입니다. 이 텍스트는 항상 표시됩니다. |
리턴
Text - 연결을 위한 이 객체
set
Google Workspace 애플리케이션의 데이터 소스를 설정합니다. 현재 사용자 및 Chat 스페이스를 지원합니다.
Google Workspace Studio를 확장하는 Google Workspace 부가기능에만 사용할 수 있습니다.
const workflowDataSource = CardService.newWorkflowDataSource().setIncludeVariables(true); const hostAppDataSource = CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource); const textInput = CardService.newTextInput() .setFieldName('text_input_form_input_key') .setTitle('Text input title') .setHint('Text input hint') .setHostAppDataSource(hostAppDataSource);
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
host | Host | 데이터 소스입니다. |
리턴
Text - 연결을 위한 이 객체
set
변형할 위젯을 식별하는 데 사용되는 할당된 고유 ID를 설정합니다. 위젯 변형은 부가기능에서만 지원됩니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
id | String | 위젯의 ID입니다. 64자(영문 기준)로 제한되며 `[a-zA-Z0-9-]+` 형식입니다. |
리턴
Widget - 연결을 위한 이 객체
set
이 텍스트 입력란이 변수 삽입을 지원하는지 여부를 설정합니다.
Google Workspace Studio를 확장하는 Google Workspace 부가기능에만 사용할 수 있습니다.
const textInput = CardService.newTextInput() .setFieldName('text_input_form_input_key') .setTitle('Text input title') .setInputMode(CardService.TextInputMode.PLAIN_TEXT);
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
input | Text | 이 텍스트 입력 필드에 허용되는 입력 유형입니다. 변수 삽입을 지원하려면 RICH_TEXT를 사용하세요. |
리턴
Text - 연결을 위한 이 객체
set
입력 텍스트가 한 줄로 표시되는지 여러 줄로 표시되는지 설정합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
multiline | Boolean | 여러 줄 설정입니다. |
리턴
Text - 연결을 위한 이 객체
set
set
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 - 연결을 위한 이 객체
set
위젯의 공개 상태를 설정합니다. 기본값은 `VISIBLE`입니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
visibility | Visibility | 위젯의 Visibility입니다. |
리턴
Widget - 연결을 위한 객체입니다.