켜거나 끌 수 있는 UI 요소입니다. Decorated
위젯 내에서만 사용할 수 있습니다.
Google Workspace 부가기능 및 Google Chat 앱에서 사용할 수 있습니다.
const 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'), ), );
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
set | Switch | 스위치의 컨트롤 유형을 설정합니다. |
set | Switch | UI 상호작용이 있을 때 생성되는 이벤트 객체에서 이 스위치를 식별하는 키를 설정합니다. |
set | Switch | 스위치가 전환될 때 실행할 작업을 설정합니다. |
set | Switch | 이 스위치가 선택된 상태로 시작할지 선택 해제된 상태로 시작할지 설정합니다. |
set | Switch | 이 스위치가 켜지면 양식 입력으로 전송되는 값을 설정합니다. |
자세한 문서
set Control Type(controlType)
스위치의 컨트롤 유형을 설정합니다. 기본값은 SWITCH
입니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
control | Switch | 스위치 제어 유형입니다. |
리턴
Switch
: 연결을 위한 객체입니다.
set Field Name(fieldName)
UI 상호작용이 있을 때 생성되는 이벤트 객체에서 이 스위치를 식별하는 키를 설정합니다. 사용자에게 표시되지 않습니다. 필수 항목입니다.
다른 양식 필드와 달리 이 필드 이름은 고유하지 않아도 됩니다. 동일한 필드 이름을 사용하는 스위치의 양식 입력 값은 배열로 반환됩니다. 배열은 해당 필드 이름의 사용 설정된 모든 스위치의 값으로 구성됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
field | String | 이 스위치를 식별하는 데 사용되는 키입니다. |
리턴
Switch
: 연결을 위한 객체입니다.
set On Change Action(action)
set Selected(selected)
이 스위치가 선택된 상태로 시작할지 선택 해제된 상태로 시작할지 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
selected | Boolean | 시작 스위치 상태 설정입니다. |
리턴
Switch
: 연결을 위한 객체입니다.
set Value(value)
이 스위치가 켜지면 양식 입력으로 전송되는 값을 설정합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
value | String | 스위치가 켜져 있을 때 이름과 연결된 값입니다. 이 값이 양식 콜백으로 전송되면 항상 문자열로 표시됩니다. |
리턴
Switch
: 연결을 위한 객체입니다.