Kolom input yang memungkinkan pemilihan antara serangkaian opsi yang telah ditentukan.
var checkboxGroup = CardService.newSelectionInput() .setType(CardService.SelectionInputType.CHECK_BOX) .setTitle("A group of checkboxes. Multiple selections are allowed.") .setFieldName("checkbox_field") .addItem("checkbox one title", "checkbox_one_value", false) .addItem("checkbox two title", "checkbox_two_value", true) .addItem("checkbox three title", "checkbox_three_value", true) .setOnChangeAction(CardService.newAction() .setFunctionName("handleCheckboxChange")); var radioGroup = CardService.newSelectionInput() .setType(CardService.SelectionInputType.RADIO_BUTTON) .setTitle("A group of radio buttons. Only a single selection is allowed.") .setFieldName("checkbox_field") .addItem("radio button one title", "radio_one_value", true) .addItem("radio button two title", "radio_two_value", false) .addItem("radio button three title", "radio_three_value", false);
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
addItem(text, value, selected) | SelectionInput | Menambahkan item baru yang dapat dipilih. |
setFieldName(fieldName) | SelectionInput | Menetapkan kunci yang mengidentifikasi input pemilihan ini dalam objek peristiwa yang dihasilkan saat ada interaksi UI. |
setOnChangeAction(action) | SelectionInput | Menetapkan Action agar dilakukan setiap kali input pemilihan berubah. |
setTitle(title) | SelectionInput | Menetapkan judul yang akan ditampilkan sebelum kolom input. |
setType(type) | SelectionInput | Menetapkan jenis input ini. |
Dokumentasi mendetail
addItem(text, value, selected)
Menambahkan item baru yang dapat dipilih.
Parameter
Nama | Type | Deskripsi |
---|---|---|
text | Object | Teks yang akan ditampilkan untuk item ini. Argumen primitif non-string dikonversi menjadi string secara otomatis. |
value | Object | Nilai input formulir yang dikirim melalui callback. Argumen primitif non-string dikonversi secara otomatis ke string. |
selected | Boolean | Apakah item dipilih secara default atau tidak. Jika input pemilihan hanya menerima satu nilai (seperti untuk tombol pilihan atau menu dropdown), hanya tetapkan kolom ini untuk satu item. |
Return
SelectionInput
— Objek ini, untuk perantaian.
setFieldName(fieldName)
Menetapkan kunci yang mengidentifikasi input pemilihan ini dalam objek peristiwa yang dihasilkan saat ada interaksi UI. Tidak terlihat oleh pengguna. Wajib, harus unik.
Parameter
Nama | Type | Deskripsi |
---|---|---|
fieldName | String | Nama yang akan ditetapkan untuk input ini. |
Return
SelectionInput
— Objek ini, untuk perantaian.
setOnChangeAction(action)
Menetapkan Action
agar dilakukan setiap kali input pemilihan berubah.
Parameter
Nama | Type | Deskripsi |
---|---|---|
action | Action | Tindakan yang akan diambil. |
Return
SelectionInput
— Objek ini, untuk perantaian.
setTitle(title)
Menetapkan judul yang akan ditampilkan sebelum kolom input.
Parameter
Nama | Type | Deskripsi |
---|---|---|
title | String | Judul kolom input. |
Return
SelectionInput
— Objek ini, untuk perantaian.
setType(type)
Menetapkan jenis input ini. Default-nya adalah CHECKBOX
.
Parameter
Nama | Type | Deskripsi |
---|---|---|
type | SelectionInputType | Jenis pilihan. |
Return
SelectionInput
— Objek ini, untuk perantaian.