사용 설정 또는 사용 중지를 지원하는 UI 요소입니다. DecoratedText 위젯 내에서만 사용할 수 있습니다.
Google Workspace 부가기능 및 Google Chat 앱에서 사용할 수 있습니다.
var switchDecoratedText = CardService.newDecoratedText()
.setTopLabel("Switch decorated text widget label")
.setText("This is a decorated text widget with a switch on the right")
.setWrapText(true)
.setSwitchControl(CardService.newSwitch()
.setFieldName("form_input_switch_key")
.setValue("form_input_switch_value")
.setOnChangeAction(CardService.newAction()
.setFunctionName("handleSwitchChange")));
메서드
| 메서드 | 반환 유형 | 간략한 설명 |
|---|---|---|
setControlType(controlType) | Switch | 스위치의 컨트롤 유형을 설정합니다. |
setFieldName(fieldName) | Switch | 이(가) 있을 때 생성되는 이벤트 객체에서 이 스위치를 식별하는 키를 설정합니다. UI 상호작용입니다. |
setOnChangeAction(action) | Switch | 스위치가 전환될 때 실행할 작업을 설정합니다. |
setSelected(selected) | Switch | 이 스위치를 선택한 상태로 시작할지 또는 선택 해제한 상태로 시작할지 설정합니다. |
setValue(value) | Switch | 이 스위치를 켜면 양식 입력으로 전송될 값을 설정합니다. |
자세한 문서
setControlType(controlType)
스위치의 컨트롤 유형을 설정합니다. 기본값은 SWITCH입니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
controlType | SwitchControlType | 스위치 컨트롤 유형입니다. |
리턴
Switch - 체이닝을 위한 객체입니다.
setFieldName(fieldName)
이(가) 있을 때 생성되는 이벤트 객체에서 이 스위치를 식별하는 키를 설정합니다. UI 상호작용입니다. 사용자에게 표시되지 않습니다. 필수 항목입니다.
다른 양식 입력란과 달리 이 입력란 이름은 고유하지 않아도 됩니다. 양식 입력 값 는 배열로 반환됩니다. 배열은 값이 표시됩니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
fieldName | String | 이 스위치를 식별하는 데 사용되는 키입니다. |
리턴
Switch - 체이닝을 위한 객체입니다.
setOnChangeAction(action)
setSelected(selected)
이 스위치를 선택한 상태로 시작할지 또는 선택 해제한 상태로 시작할지 설정합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
selected | Boolean | 시작 스위치 상태 설정입니다. |
리턴
Switch - 체이닝을 위한 객체입니다.
setValue(value)
이 스위치를 켜면 양식 입력으로 전송될 값을 설정합니다.
매개변수
| 이름 | 유형 | 설명 |
|---|---|---|
value | String | 스위치가 켜졌을 때 이름과 연결된 값입니다. 이것이 항상 문자열로 표현됩니다. |
리턴
Switch - 체이닝을 위한 객체입니다.