Halaman ini diterjemahkan oleh Cloud Translation API.

Class SelectionInput

Kolom input yang memungkinkan pemilihan di antara sekumpulan opsi standar.

Tersedia untuk Add-on Google Workspace dan aplikasi Google Chat.

const 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'),
        );

const 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 multi-pilih.
`setExternalDataSource(action)`	`SelectionInput`	Menetapkan sumber data eksternal, seperti database relasional.
`setFieldName(fieldName)`	`SelectionInput`	Menetapkan kunci yang mengidentifikasi input pilihan 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 melakukan pelengkapan otomatis dan menampilkan item yang disarankan di kartu.
`setOnChangeAction(action)`	`SelectionInput`	Menetapkan `Action` yang akan 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 dikonversi menjadi string secara otomatis.
`selected`	`Boolean`	Apakah item dipilih secara default. Jika input pilihan hanya menerima satu nilai (seperti untuk tombol pilihan atau menu dropdown), hanya tetapkan kolom ini untuk satu item.

Pulang pergi

SelectionInput — Objek ini, untuk pembuatan rantai.

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

Menambahkan item baru yang dapat dipilih, untuk menu multi-pilih.

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 dikonversi menjadi string secara otomatis.
`selected`	`Boolean`	Apakah item dipilih secara default. Jika input pilihan hanya menerima satu nilai (seperti untuk tombol pilihan atau menu dropdown), hanya tetapkan kolom ini untuk satu item.
`startIconUri`	`Object`	Untuk menu multipilih, URL untuk ikon yang ditampilkan di samping kolom teks item. Mendukung file PNG dan JPEG.
`bottomText`	`Object`	Untuk menu multipilih, deskripsi teks atau label yang ditampilkan di bawah kolom teks item.

Pulang pergi

SelectionInput — Objek ini, untuk pembuatan rantai.

`setExternalDataSource(action)`

Menetapkan sumber data eksternal, seperti database 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 pembuatan rantai.

`setFieldName(fieldName)`

Menetapkan kunci yang mengidentifikasi input pilihan ini dalam objek peristiwa yang dihasilkan 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 pembuatan rantai.

`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 maksimum item.

Pulang pergi

SelectionInput — Objek ini, untuk pembuatan rantai.

`setMultiSelectMinQueryLength(queryLength)`

Menetapkan jumlah karakter teks yang dimasukkan pengguna sebelum kueri aplikasi melakukan pelengkapan otomatis dan menampilkan item yang disarankan di 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 pembuatan rantai.

`setOnChangeAction(action)`

Menetapkan Action yang akan dilakukan setiap kali input pilihan berubah.

Parameter

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

Pulang pergi

SelectionInput — Objek ini, untuk pembuatan rantai.

`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 pembuatan rantai.

`setTitle(title)`

Menetapkan judul yang akan ditampilkan di depan kolom input.

Parameter

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

Pulang pergi

SelectionInput — Objek ini, untuk pembuatan rantai.

`setType(type)`

Menetapkan jenis input ini. Default-nya adalah CHECKBOX.

Parameter

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

Pulang pergi

SelectionInput — Objek ini, untuk pembuatan rantai.