Class Switch

Ganti

Elemen UI yang mendukung pengaktifan atau penonaktifan. Elemen ini hanya dapat digunakan dalam widget DecoratedText.

Tersedia untuk add-on Google Workspace dan aplikasi 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'),
                    ),
        );

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
setControlType(controlType)	Switch	Menetapkan jenis kontrol tombol akses.
setFieldName(fieldName)	Switch	Menetapkan tombol yang mengidentifikasi tombol ini dalam objek peristiwa yang dibuat saat ada interaksi UI.
setOnChangeAction(action)	Switch	Menetapkan tindakan yang harus dilakukan saat tombol diaktifkan.
setSelected(selected)	Switch	Menetapkan apakah tombol ini harus dimulai sebagai dipilih atau tidak dipilih.
setValue(value)	Switch	Menetapkan nilai yang dikirim sebagai input formulir saat tombol ini diaktifkan.

Dokumentasi mendetail

setControlType(controlType)

Menetapkan jenis kontrol tombol akses. Default-nya adalah SWITCH.

Parameter

Nama	Jenis	Deskripsi
controlType	SwitchControlType	Jenis kontrol tombol akses.

Pulang pergi

Switch — Objek ini, untuk dirangkaikan.

---

setFieldName(fieldName)

Menetapkan tombol yang mengidentifikasi tombol ini dalam objek peristiwa yang dibuat saat ada interaksi UI. Tidak terlihat oleh pengguna. Wajib.

Tidak seperti kolom formulir lainnya, nama kolom ini tidak harus unik. Nilai input formulir untuk tombol yang menggunakan nama kolom yang sama ditampilkan sebagai array. Array terdiri dari nilai untuk semua tombol yang diaktifkan dengan nama kolom tersebut.

Parameter

Nama	Jenis	Deskripsi
fieldName	String	Kunci yang digunakan untuk mengidentifikasi tombol ini.

Pulang pergi

Switch — Objek ini, untuk dirangkaikan.

---

setOnChangeAction(action)

Menetapkan tindakan yang harus dilakukan saat tombol diaktifkan.

Parameter

Nama	Jenis	Deskripsi
action	Action	Tindakan yang harus diambil saat tombol diaktifkan.

Pulang pergi

Switch — Objek ini, untuk dirangkaikan.

---

setSelected(selected)

Menetapkan apakah tombol ini harus dimulai sebagai dipilih atau tidak dipilih.

Parameter

Nama	Jenis	Deskripsi
selected	Boolean	Setelan status sakelar awal.

Pulang pergi

Switch — Objek ini, untuk dirangkaikan.

---

setValue(value)

Menetapkan nilai yang dikirim sebagai input formulir saat tombol ini diaktifkan.

Parameter

Nama	Jenis	Deskripsi
value	String	Nilai yang terkait dengan nama saat tombol diaktifkan. Saat dikirim ke callback formulir, nilai ini selalu ditampilkan sebagai string.

Pulang pergi

Switch — Objek ini, untuk dirangkaikan.