Bagikan melalui

Kontrol Kotak kombo di Power Apps

  • Artikel

Kontrol yang memungkinkan pengguna memilih dari pilihan yang tersedia. Mendukung pencarian dan beberapa pilihan.

KETERANGAN

Kontrol Kotak kombo memungkinkan Anda untuk mencari item yang akan Anda pilih. Pencarian dilakukan di sisi server di properti SearchField agar kinerja tidak terpengaruh oleh sumber data besar.

Mode tunggal atau multipilih dikonfigurasi melalui properti SelectMultiple.

Saat mencari item yang akan dipilih, untuk setiap item-nya Anda dapat memilih untuk menampilkan nilai data tunggal, dua nilai, atau gambar dan dua nilai (Orang) dengan memodifikasi pengaturan Tata Letak di panel Data.

Saat dilihat di layar kecil, flyout daftar item akan menjadi kontrol layar penuh untuk kegunaan yang lebih baik.

Catatan

Jika Anda ingin mencari item dengan angka, konversikan angka menjadi teks dengan fungsi Text(). Contohnya, Text(12345).

Pembatasan

Kontrol kotak kombo memiliki batasan berikut:

  • Saat Anda menggunakan kontrol Kotak kombo di dalam galeri, pilihannya tidak dipertahankan saat pengguna menggulir galeri. Ini bukan masalah jika Anda menggunakan kontrol Kotak kombo di dalam galeri yang tidak bergulir. Solusi saat ini tidak tersedia.

Pemilih orang

Untuk menggunakan Kotak kombo sebagai pemilih orang, pilih templat Orang pengaturan Tata Letak di panel Data dan konfigurasikan properti data terkait yang akan ditampilkan untuk orang di bawah ini.

Properti utama

Items – Sumber data untuk memilih.

DefaultSelectedItems – Item terpilih awal sebelum pengguna berinteraksi dengan kontrol.

Catatan

Properti Default tidak digunakan lagi, gunakan DefaultSelectedItems.

SelectedItems – Daftar item terpilih yang dihasilkan dari interaksi pengguna.

SelectMultiple – Mengatur apakah pengguna dapat memilih satu item atau beberapa item.

IsSearchable – Mengatur apakah pengguna dapat mencari item sebelum memilih.

Catatan

IsSearchable dapat diaktifkan hanya pada sumber data yang berisi sekurangnya satu bidang teks. Ekspresi Item harus dapat didelegasikan agar kueri didelegasikan dengan pencarian. Artinya, pernyataan Jika dalam ekspresi Item tidak didukung.

SearchFields - Bidang data yang sumber data yang dicari saat pengguna memasukkan teks.

Catatan

Untuk mencari pada beberapa bidang, atur properti SearchFields dalam format ini: ["MyFirstColumn", "MySecondColumn"]. Hanya bidang teks yang didukung.

Properti tambahan

AccessibleLabel – Label untuk pembaca layar.

BorderColor – Warna batas kontrol.

BorderStyle – Mengatur apakah batas kontrol Solid, Putus-Putus, Bertitik, atau Tidak Ada.

BorderThickness – Ketebalan batas kontrol.

DisplayFields – Daftar bidang yang ditampilkan untuk setiap item yang dihasilkan oleh pencarian. Yang paling mudah adalah untuk mengonfigurasi melalui panel Data di tab opsi Properti.

Catatan

Untuk memperbarui beberapa bidang tampilan di template tertentu, atur properti DisplayFields dalam format ini: ["MyFirstColumn", "MySecondColumn"]

DisplayMode – Mengatur apakah kontrol memungkinkan pengguna untuk menginput (Edit), hanya menampilkan data (Tampilkan), atau dinonaktifkan (Nonaktif).

FocusedBorderColor – Warna batas kontrol saat kontrol difokuskan.

FocusedBorderThickness – Ketebalan batas kontrol saat kontrol difokuskan.

Height – Jarak antara tepi atas dan bawah kontrol.

InputTextPlaceholder – Teks instruksional yang ditampilkan kepada pengguna akhir saat tidak ada item yang dipilih.

OnChange – Tindakan untuk dilakukan saat pengguna mengubah pilihan.

OnNavigate – Tindakan untuk dilakukan saat pengguna memilih item.

OnSelect – Tindakan untuk dilakukan ketika pengguna mengetuk atau memilih kontrol.

TabIndex – Perintah navigasi keyboard terkait dengan kontrol lainnya.

Visible – Mengatur apakah kontrol akan muncul atau tersembunyi.

Width – Jarak antara tepi kiri dan kanan kontrol.

X – Jarak antara tepi kiri kontrol dan tepi kiri wadah induknya (layar, jika tidak ada wadah induk).

Y – Jarak antara tepi atas dan tepi atas wadah induk (layar, jika tidak ada wadah induk).

Catatan

Properti batas flyout dikontrol oleh properti Batas.

Contoh

Combo box dasar

Langkah-langkah dalam contoh ini berlaku untuk semua sumber data yang menyediakan tabel, namun untuk mengikuti langkah-langkah ini dengan tepat, gunakan lingkungan dengan database Microsoft Dataverse yang memiliki data sampel.

  1. Pilih Masukkan > Input > Kotak Kombo, lalu namai "Combobox1".

  2. Pada panel Properti di sisi kanan layar, buka daftar Pilih sumber data (di sebelah Item), lalu tambahkan atau pilih sumber data seperti tabel Akun.

  3. Pada panel yang sama, pilih Edit (di samping Bidang).

  4. Di panel Data, buka daftar teks Utama, lalu pilih kolom Nama Utama yang akan ditampilkan dalam kontrol kotak Kombo.

  5. Sambil menekan terus tombol Alt, pilih panah bawah untuk membuka kontrol Kotak kombo.

    Kontrol akan menampilkan data dari Nama Utama yang Anda tentukan di sumber data yang Anda tentukan.

(Opsional) Menampilkan rekaman pertama secara default

  1. Atur properti DefaultSelectedItems ke ekspresi ini, ganti DataSource dengan nama sumber data Anda:

    First(DataSource)

(Opsional) Menampilkan nilai Nama Akun yang dipilih di label

  1. Pilih Sisipkan > Label Teks, lalu pilih Label.

  2. Atur properti Teks ke ekspresi ini, ganti Teks dengan rumus berikut:

    If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")

    Catatan

    Pernyataan Jika akan memeriksa untuk melihat bagaimana item yang dipilih ada dan menampilkannya dalam label dibatasi koma atau pesan "TIDAK ADA ITEM YANG DIPILIH" saat kosong.

Mensimulasikan perilaku drop down sederhana

Dengan mengatur IsSearchable ke salah dan SelectMultiple menjadi salah, Anda dapat mencapai fungsi drop down yang sama.

  1. Pilih Masukkan > Input, lalu pilih kotak Kombo.

  2. Pada panel Properti di sisi kanan layar, buka daftar Pilih sumber data (di sebelah Item), lalu tambahkan atau pilih sumber data.

  3. Pada panel yang sama, pilih Edit (di samping Bidang).

  4. Di panel Data, buka daftar Teks utama, lalu pilih kolom yang ingin Anda ditampilkan di kontrol Kotak kombo.

  5. Atur properti IsSearchable ke salah.

  6. Atur properti SelectMultiple ke salah.

  7. Sambil menekan terus tombol Alt, pilih panah bawah untuk membuka kontrol Kotak kombo.

    Kontrol akan menampilkan data dari kolom yang Anda tetapkan di sumber data yang Anda tetapkan.

    Catatan

    Teks "Cari item" telah hilang, dan Anda hanya dapat memilih satu item.

Panduan aksesibilitas

Kontras warna

Harus ada kontras warna yang memadai antara:

  • ChevronFill dan ChevronBackground
  • ChevronHoverFill dan ChevronHoverBackground
  • SelectionColor dan SelectionFill
  • SelectionFill dan Fill
  • SelectionTagColor dan SelectionTagFill

Ini adalah tambahan untuk persyaratan kontras warna standar.

Dukungan pembaca layar

  • AccessibleLabel harus ada.

    Catatan

    Pada layar sentuh, pengguna pembaca layar dapat menavigasi konten kotak kombo secara berurutan. Kotak kombo berfungsi sebagai tombol yang menampilkan atau menyembunyikan kontennya saat dipilih.

Dukungan keyboard

  • TabIndex harus nol atau lebih besar supaya pengguna keyboard dapat menavigasi ke arahnya.

  • Indikator fokus harus terlihat jelas. Gunakan FocusedBorderColor dan FocusedBorderThickness untuk mencapai hal ini.

    Catatan

    Tombol tab menavigasi ke atau menjauh dari kotak kombo. Tombol panah menavigasi konten kotak kombo. Tombol escape akan menutup daftar menurun, jika dibuka.

Catatan

Apa bahasa dokumentasi yang Anda inginkan? Lakukan survei singkat. (perlu diketahui bahwa survei ini dalam bahasa Inggris)

Survei akan berlangsung kurang lebih selama tujuh menit. Tidak ada data pribadi yang dikumpulkan (pernyataan privasi).