Kolom input yang memungkinkan Anda memilih di antara kumpulan opsi standar.
Tersedia untuk Add-on Google Workspace dan aplikasi Google Chat.
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); const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("multiselect") .setTitle("A multi select input example.") .addMultiSelectItem("Contact 1", "contact-1", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact one description") .addMultiSelectItem("Contact 2", "contact-2", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact two description") .addMultiSelectItem("Contact 3", "contact-3", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact three description") .addMultiSelectItem("Contact 4", "contact-4", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact four description") .addMultiSelectItem("Contact 5", "contact-5", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact five description") .setMultiSelectMaxSelectedItems(3) .setMultiSelectMinQueryLength(1);
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
addItem(text, value, selected) | SelectionInput | Menambahkan item baru yang dapat dipilih. |
addMultiSelectItem(text, value, selected, startIconUri, bottomText) | SelectionInput | Menambahkan item baru yang dapat dipilih, untuk menu pilihan ganda. |
setExternalDataSource(action) | SelectionInput | Menetapkan sumber data eksternal, seperti basis data relasional. |
setFieldName(fieldName) | SelectionInput | Menetapkan kunci yang mengidentifikasi input pemilihan ini dalam objek peristiwa yang dihasilkan saat ada interaksi UI. |
setMultiSelectMaxSelectedItems(maxSelectedItems) | SelectionInput | Menetapkan jumlah maksimum item yang dapat dipilih pengguna. |
setMultiSelectMinQueryLength(queryLength) | SelectionInput | Menetapkan jumlah karakter teks yang dimasukkan pengguna sebelum kueri aplikasi selesai dilengkapi secara otomatis dan menampilkan item yang disarankan pada kartu. |
setOnChangeAction(action) | SelectionInput | Menyetel Action untuk dilakukan setiap kali input pilihan berubah. |
setPlatformDataSource(platformDataSource) | SelectionInput | Menetapkan sumber data dari Google Workspace. |
setTitle(title) | SelectionInput | Menetapkan judul yang akan ditampilkan di depan kolom input. |
setType(type) | SelectionInput | Menetapkan jenis input ini. |
Dokumentasi mendetail
addItem(text, value, selected)
Menambahkan item baru yang dapat dipilih.
Parameter
Nama | Jenis | 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 akan otomatis dikonversi menjadi string. |
selected | Boolean | Apakah item dipilih secara default. Jika input pemilihan hanya menerima satu nilai (misalnya untuk tombol pilihan atau menu dropdown), tetapkan kolom ini untuk satu item saja. |
Return
SelectionInput
— Objek ini, untuk perantaian.
addMultiSelectItem(text, value, selected, startIconUri, bottomText)
Menambahkan item baru yang dapat dipilih, untuk menu pilihan ganda.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("multiselect") .setTitle("A multi select input example.") .addMultiSelectItem("Contact 1", "contact-1", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact one description") .addMultiSelectItem("Contact 2", "contact-2", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact two description") .addMultiSelectItem("Contact 3", "contact-3", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact three description") .addMultiSelectItem("Contact 4", "contact-4", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact four description") .addMultiSelectItem("Contact 5", "contact-5", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact five description");
Parameter
Nama | Jenis | 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 akan otomatis dikonversi menjadi string. |
selected | Boolean | Apakah item dipilih secara default. Jika input pemilihan hanya menerima satu nilai (misalnya untuk tombol pilihan atau menu dropdown), tetapkan kolom ini untuk satu item saja. |
startIconUri | Object | Untuk menu dengan banyak pilihan, URL untuk ikon yang ditampilkan di samping kolom teks item. Mendukung file PNG dan JPEG. |
bottomText | Object | Untuk menu multi-pilihan, deskripsi teks atau label yang ditampilkan di bawah kolom teks item. |
Return
SelectionInput
— Objek ini, untuk perantaian.
setExternalDataSource(action)
Menetapkan sumber data eksternal, seperti basis data relasional.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("contacts") .setTitle("Selected contacts") .addMultiSelectItem("Contact 3", "contact-3", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact three description") .setMultiSelectMaxSelectedItems(5) .setMultiSelectMinQueryLength(2) .setExternalDataSource(CardService.newAction().setFunctionName("getContacts"));
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
action | Action | Sumber data eksternal. |
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 | Jenis | Deskripsi |
---|---|---|
fieldName | String | Nama yang akan ditetapkan ke input ini. |
Return
SelectionInput
— Objek ini, untuk perantaian.
setMultiSelectMaxSelectedItems(maxSelectedItems)
Menetapkan jumlah maksimum item yang dapat dipilih pengguna.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("multiselect") .setTitle("A multi select input example.") .setMultiSelectMaxSelectedItems(3) .addMultiSelectItem("Contact 1", "contact-1", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact one description") .addMultiSelectItem("Contact 2", "contact-2", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact two description") .addMultiSelectItem("Contact 3", "contact-3", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact three description") .addMultiSelectItem("Contact 4", "contact-4", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact four description") .addMultiSelectItem("Contact 5", "contact-5", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact five description");
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
maxSelectedItems | Integer | Jumlah item maksimum. |
Return
SelectionInput
— Objek ini, untuk perantaian.
setMultiSelectMinQueryLength(queryLength)
Menetapkan jumlah karakter teks yang dimasukkan pengguna sebelum kueri aplikasi selesai dilengkapi secara otomatis dan menampilkan item yang disarankan pada kartu.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("multiselect") .setTitle("A multi select input example.") .setMultiSelectMinQueryLength(1) .addMultiSelectItem("Contact 1", "contact-1", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact one description") .addMultiSelectItem("Contact 2", "contact-2", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact two description") .addMultiSelectItem("Contact 3", "contact-3", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact three description") .addMultiSelectItem("Contact 4", "contact-4", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact four description") .addMultiSelectItem("Contact 5", "contact-5", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact five description");
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
queryLength | Integer | Jumlah karakter teks. |
Return
SelectionInput
— Objek ini, untuk perantaian.
setOnChangeAction(action)
Menyetel Action
untuk dilakukan setiap kali input pilihan berubah.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
action | Action | Tindakan yang harus diambil. |
Return
SelectionInput
— Objek ini, untuk perantaian.
setPlatformDataSource(platformDataSource)
Menetapkan sumber data dari Google Workspace. Digunakan untuk mengisi item di menu multi-pilihan.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("contacts") .setTitle("Selected contacts") .setPlatformDataSource( CardService.newPlatformDataSource() .setCommonDataSource(CardService.CommonDataSource.USER));Hanya tersedia untuk aplikasi Google Chat. Tidak tersedia untuk Add-on Google Workspace.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
platformDataSource | PlatformDataSource | Sumber data. |
Return
SelectionInput
— Objek ini, untuk perantaian.
setTitle(title)
Menetapkan judul yang akan ditampilkan di depan kolom input.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
title | String | Judul kolom input. |
Return
SelectionInput
— Objek ini, untuk perantaian.
setType(type)
Menetapkan jenis input ini. Default-nya adalah CHECKBOX
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
type | SelectionInputType | Jenis pilihan. |
Return
SelectionInput
— Objek ini, untuk perantaian.