หน้านี้ได้รับการแปลโดย Cloud Translation API

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 — ออบเจ็กต์นี้สําหรับการต่อเชื่อม