องค์ประกอบ 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 | ค่าที่เชื่อมโยงกับชื่อเมื่อสวิตช์เปิดอยู่ เมื่อมีการส่งข้อมูลนี้ไปยัง Callback ก็จะแสดงเป็นสตริงเสมอ |
รีเทิร์น
Switch — ออบเจ็กต์นี้สำหรับการทำห่วงโซ่