องค์ประกอบ UI ที่รองรับการสลับเปิดหรือปิด โดยใช้ได้เฉพาะในวิดเจ็ต DecoratedText
เท่านั้น
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
— เป็นออบเจ็กต์นี้เพื่อเป็นเชน