Elemen UI yang mendukung untuk diaktifkan atau dinonaktifkan. Ini hanya dapat digunakan dalam widget 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")));
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
setControlType(controlType) | Switch | Menetapkan jenis kontrol tombol. |
setFieldName(fieldName) | Switch | Menetapkan kunci yang mengidentifikasi tombol ini di objek peristiwa yang dihasilkan saat ada interaksi UI. |
setOnChangeAction(action) | Switch | Menetapkan tindakan yang akan diambil saat tombol dialihkan. |
setSelected(selected) | Switch | Menetapkan apakah tombol ini harus dimulai sebagai dipilih atau batal dipilih. |
setValue(value) | Switch | Menetapkan nilai yang dikirim sebagai input formulir saat tombol ini diaktifkan. |
Dokumentasi mendetail
setControlType(controlType)
Menetapkan jenis kontrol tombol. Default-nya adalah SWITCH
.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
controlType | SwitchControlType | Jenis kontrol tombol. |
Return
Switch
— Objek ini, untuk rantai.
setFieldName(fieldName)
Menetapkan kunci yang mengidentifikasi tombol ini di objek peristiwa yang dihasilkan saat ada interaksi UI. Tidak terlihat oleh pengguna. Wajib diisi.
Tidak seperti kolom formulir lainnya, nama kolom ini tidak harus unik. Nilai input formulir untuk tombol yang menggunakan nama kolom yang sama akan ditampilkan sebagai array. Array terdiri dari nilai untuk semua tombol yang diaktifkan dengan nama kolom tersebut.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
fieldName | String | Kunci yang digunakan untuk mengidentifikasi tombol ini. |
Return
Switch
— Objek ini, untuk rantai.
setOnChangeAction(action)
setSelected(selected)
Menetapkan apakah tombol ini harus dimulai sebagai dipilih atau batal dipilih.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
selected | Boolean | Setelan status tombol akses awal. |
Return
Switch
— Objek ini, untuk rantai.
setValue(value)
Menetapkan nilai yang dikirim sebagai input formulir saat tombol ini diaktifkan.
Parameter
Name | Jenis | Deskripsi |
---|---|---|
value | String | Nilai yang terkait dengan nama saat tombol aktif. Ketika dikirim ke callback formulir, callback ini selalu direpresentasikan sebagai string. |
Return
Switch
— Objek ini, untuk rantai.