Halaman ini diterjemahkan oleh Cloud Translation API.

Class SelectionInput

Kolom input yang memungkinkan Anda memilih di antara serangkaian opsi yang telah ditentukan.

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 yang multi-pilihan.
`setExternalDataSource(action)`	`SelectionInput`	Menetapkan sumber data eksternal, seperti basis data relasional.
`setFieldName(fieldName)`	`SelectionInput`	Menetapkan kunci yang mengidentifikasi input pilihan ini dalam objek peristiwa yang dibuat saat ada interaksi UI.
`setMultiSelectMaxSelectedItems(maxSelectedItems)`	`SelectionInput`	Menetapkan jumlah item maksimum yang dapat dipilih pengguna.
`setMultiSelectMinQueryLength(queryLength)`	`SelectionInput`	Menetapkan jumlah karakter teks yang dimasukkan pengguna sebelum kueri aplikasi pelengkapan otomatis dan menampilkan item yang disarankan pada kartu.
`setOnChangeAction(action)`	`SelectionInput`	Menetapkan `Action` untuk dilakukan setiap kali input pilihan berubah.
`setPlatformDataSource(platformDataSource)`	`SelectionInput`	Menetapkan sumber data dari Google Workspace.
`setTitle(title)`	`SelectionInput`	Menetapkan judul untuk 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	Jenis	Deskripsi
`text`	`Object`	Teks yang akan ditampilkan untuk item ini. Argumen primitif non-string dikonversi menjadi {i>string<i} secara otomatis.
`value`	`Object`	Nilai input formulir yang dikirim melalui callback. Argumen primitif non-string dikonversi menjadi {i>string<i} secara otomatis.
`selected`	`Boolean`	Apakah item dipilih secara default. Jika input pilihan hanya menerima satu nilai (seperti untuk tombol pilihan atau menu dropdown), hanya setel kolom ini untuk satu item.

Pulang pergi

SelectionInput — Objek ini, untuk perantaian.

`addMultiSelectItem(text, value, selected, startIconUri, bottomText)`

Menambahkan item baru yang dapat dipilih untuk menu pilihan yang multi-pilihan.

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 {i>string<i} secara otomatis.
`value`	`Object`	Nilai input formulir yang dikirim melalui callback. Argumen primitif non-string dikonversi menjadi {i>string<i} secara otomatis.
`selected`	`Boolean`	Apakah item dipilih secara default. Jika input pilihan hanya menerima satu nilai (seperti untuk tombol pilihan atau menu dropdown), hanya setel kolom ini untuk satu item.
`startIconUri`	`Object`	Untuk menu multi-pilihan, URL untuk ikon yang ditampilkan di samping kolom teks. Mendukung file PNG dan JPEG.
`bottomText`	`Object`	Untuk menu pilihan banyak, deskripsi teks atau label yang ditampilkan di bawah isian teks item.

Pulang pergi

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.

Pulang pergi

SelectionInput — Objek ini, untuk perantaian.

`setFieldName(fieldName)`

Menetapkan kunci yang mengidentifikasi input pilihan ini dalam objek peristiwa yang dibuat saat ada interaksi UI. Tidak terlihat oleh pengguna. Wajib diisi, harus unik.

Parameter

Nama	Jenis	Deskripsi
`fieldName`	`String`	Nama yang akan ditetapkan ke input ini.

Pulang pergi

SelectionInput — Objek ini, untuk perantaian.

`setMultiSelectMaxSelectedItems(maxSelectedItems)`

Menetapkan jumlah item maksimum 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.

Pulang pergi

SelectionInput — Objek ini, untuk perantaian.

`setMultiSelectMinQueryLength(queryLength)`

Menetapkan jumlah karakter teks yang dimasukkan pengguna sebelum kueri aplikasi pelengkapan 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.

Pulang pergi

SelectionInput — Objek ini, untuk perantaian.

`setOnChangeAction(action)`

Menetapkan Action untuk dilakukan setiap kali input pilihan berubah.

Parameter

Nama	Jenis	Deskripsi
`action`	`Action`	Tindakan yang harus diambil.

Pulang pergi

SelectionInput — Objek ini, untuk perantaian.

`setPlatformDataSource(platformDataSource)`

Menetapkan sumber data dari Google Workspace. Digunakan untuk mengisi item dalam 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.

Pulang pergi

SelectionInput — Objek ini, untuk perantaian.

`setTitle(title)`

Menetapkan judul untuk ditampilkan sebelum kolom input.

Parameter

Nama	Jenis	Deskripsi
`title`	`String`	Judul kolom input.

Pulang pergi

SelectionInput — Objek ini, untuk perantaian.

`setType(type)`

Menetapkan jenis input ini. Default-nya adalah CHECKBOX.

Parameter

Nama	Jenis	Deskripsi
`type`	`SelectionInputType`	Jenis pemilihan.

Pulang pergi

SelectionInput — Objek ini, untuk perantaian.