Class Switch

เปลี่ยน

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

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

พารามิเตอร์

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

รีเทิร์น

Switch — ออบเจ็กต์นี้สำหรับการทำห่วงโซ่

---

setSelected(selected)

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

พารามิเตอร์

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

รีเทิร์น

Switch — ออบเจ็กต์นี้สำหรับการทำห่วงโซ่

---

setValue(value)

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

พารามิเตอร์

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

รีเทิร์น

Switch — ออบเจ็กต์นี้สำหรับการทำห่วงโซ่