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