องค์ประกอบ UI ที่รองรับการเปิดหรือปิด คุณจะใช้ได้ภายในวิดเจ็ต DecoratedText เท่านั้น
พร้อมให้บริการสำหรับส่วนเสริมของ 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 | ตั้งค่าที่จะส่งเป็นอินพุตของแบบฟอร์มเมื่อเปิดสวิตช์นี้ |
เอกสารโดยละเอียด
setControlType(controlType)
ตั้งค่าประเภทการควบคุมของสวิตช์ ค่าเริ่มต้นคือ SWITCH
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
control | Switch | ประเภทการควบคุมสวิตช์ |
รีเทิร์น
Switch — ออบเจ็กต์นี้สำหรับการเชื่อมโยง
setFieldName(fieldName)
ตั้งค่าคีย์ที่ระบุสวิตช์นี้ในออบเจ็กต์เหตุการณ์ที่สร้างขึ้นเมื่อมีการโต้ตอบ UI ผู้ใช้จะมองไม่เห็นข้อมูลนี้ ต้องระบุ
ชื่อฟิลด์นี้ไม่จำเป็นต้องไม่ซ้ำกัน ซึ่งต่างจากฟิลด์อื่นๆ ในแบบฟอร์ม ระบบจะแสดงค่าอินพุตของแบบฟอร์ม สำหรับสวิตช์ที่ใช้ชื่อฟิลด์เดียวกันเป็นอาร์เรย์ อาร์เรย์ประกอบด้วยค่าสำหรับสวิตช์ที่เปิดใช้ทั้งหมดที่มีชื่อฟิลด์นั้น
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
field | String | คีย์ที่ใช้เพื่อระบุสวิตช์นี้ |
รีเทิร์น
Switch — ออบเจ็กต์นี้สำหรับการเชื่อมโยง
setOnChangeAction(action)
setSelected(selected)
กำหนดว่าสวิตช์นี้ควรเริ่มต้นเป็นเลือกหรือไม่ได้เลือก
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
selected | Boolean | การตั้งค่าสถานะสวิตช์เริ่มต้น |
รีเทิร์น
Switch — ออบเจ็กต์นี้สำหรับการเชื่อมโยง
setValue(value)
ตั้งค่าที่จะส่งเป็นอินพุตของแบบฟอร์มเมื่อเปิดสวิตช์นี้
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
value | String | ค่าที่เชื่อมโยงกับชื่อเมื่อสวิตช์เปิดอยู่ เมื่อส่งไปยัง การเรียกกลับของแบบฟอร์ม ระบบจะแสดงเป็นสตริงเสมอ |
รีเทิร์น
Switch — ออบเจ็กต์นี้สำหรับการเชื่อมโยง