Class SelectionInput

SelectionInput

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

MetodeJenis hasil yang ditampilkanDeskripsi singkat
addItem(text, value, selected)SelectionInputMenambahkan item baru yang dapat dipilih.
setFieldName(fieldName)SelectionInputMenetapkan kunci yang mengidentifikasi input pemilihan ini dalam objek peristiwa yang dihasilkan saat ada interaksi UI.
setOnChangeAction(action)SelectionInputMenetapkan Action agar dilakukan setiap kali input pemilihan berubah.
setTitle(title)SelectionInputMenetapkan judul yang akan ditampilkan sebelum kolom input.
setType(type)SelectionInputMenetapkan jenis input ini.

Dokumentasi mendetail

addItem(text, value, selected)

Menambahkan item baru yang dapat dipilih.

Parameter

NamaTypeDeskripsi
textObjectTeks yang akan ditampilkan untuk item ini. Argumen primitif non-string dikonversi menjadi string secara otomatis.
valueObjectNilai input formulir yang dikirim melalui callback. Argumen primitif non-string dikonversi secara otomatis ke string.
selectedBooleanApakah 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

NamaTypeDeskripsi
fieldNameStringNama yang akan ditetapkan untuk input ini.

Return

SelectionInput — Objek ini, untuk perantaian.


setOnChangeAction(action)

Menetapkan Action agar dilakukan setiap kali input pemilihan berubah.

Parameter

NamaTypeDeskripsi
actionActionTindakan yang akan diambil.

Return

SelectionInput — Objek ini, untuk perantaian.


setTitle(title)

Menetapkan judul yang akan ditampilkan sebelum kolom input.

Parameter

NamaTypeDeskripsi
titleStringJudul kolom input.

Return

SelectionInput — Objek ini, untuk perantaian.


setType(type)

Menetapkan jenis input ini. Default-nya adalah CHECKBOX.

Parameter

NamaTypeDeskripsi
typeSelectionInputTypeJenis pilihan.

Return

SelectionInput — Objek ini, untuk perantaian.