Class Switch

เปลี่ยน

องค์ประกอบ 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'),
                    ),
        );

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
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)

ตั้งค่าการดำเนินการที่จะทำเมื่อสลับสวิตช์

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
action	Action	การดำเนินการที่จะทำเมื่อสลับสวิตช์

รีเทิร์น

Switch — ออบเจ็กต์นี้สำหรับการเชื่อมโยง

---

setSelected(selected)

กำหนดว่าสวิตช์นี้ควรเริ่มต้นเป็นเลือกหรือไม่ได้เลือก

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
selected	Boolean	การตั้งค่าสถานะสวิตช์เริ่มต้น

รีเทิร์น

Switch — ออบเจ็กต์นี้สำหรับการเชื่อมโยง

---

setValue(value)

ตั้งค่าที่จะส่งเป็นอินพุตของแบบฟอร์มเมื่อเปิดสวิตช์นี้

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
value	String	ค่าที่เชื่อมโยงกับชื่อเมื่อสวิตช์เปิดอยู่ เมื่อส่งไปยัง การเรียกกลับของแบบฟอร์ม ระบบจะแสดงเป็นสตริงเสมอ

รีเทิร์น

Switch — ออบเจ็กต์นี้สำหรับการเชื่อมโยง