องค์ประกอบ 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 — ออบเจ็กต์นี้สำหรับการทำเชน