Kontrol galeri di Power Apps

Kontrol yang berisi kontrol lain dan menampilkan kumpulan data.

Description

Kontrol Galeri dapat menampilkan beberapa rekaman dari sumber data, dan setiap rekaman dapat berisi beberapa jenis data. Misalnya, gunakan kontrol Galeri untuk menampilkan beberapa kontak dengan setiap item yang memperlihatkan informasi kontak yang menyertakan nama, alamat, dan nomor telepon untuk setiap kontak.

Setiap bidang data muncul dalam kontrol terpisah dalam kontrol Galeri . Dan Anda dapat mengonfigurasi kontrol tersebut dalam templatnya. Templat muncul sebagai item pertama di dalam galeri:

• Di tepi kiri kontrol Galeri dalam orientasi horizontal/lanskap.
• Dan di bagian atas kontrol Galeri dalam orientasi vertikal/potret.

Setiap perubahan yang Anda buat dalam templat tercermin di seluruh kontrol Galeri .

Templat yang telah ditentukan sebelumnya untuk menampilkan gambar dan teks di galeri tersedia, dan galeri untuk item dengan tinggi variabel.

Keterbatasan

Kontrol galeri memiliki batasan ini:

1. Jika pengguna menggulir kontrol galeri tinggi Fleksibel sebelum semua item dimuat, item yang saat ini terlihat dapat didorong ke bawah dan tidak terlihat saat pemuatan data selesai. Untuk menghindari masalah ini, gunakan kontrol Galeri standar alih-alih varian tinggi Fleksibel.
2. Kontrol berikut ini tidak didukung dalam galeri:
   • Tampilkan formulir
   • Edit formulir
   • Penampil PDF
   • Petak peta Power BI
   • Editor teks kaya
   • Layar yang dapat digulir (Kisi fluida)
   • Pemindai kode batang web
3. Anda tidak dapat menambahkan galeri di dalam galeri lain jika yang terakhir sudah berada di dalam galeri lain. Tingkat maksimum bersarang adalah 2.
4. Ukuran Templat minimum adalah satu. Ini dapat menyebabkan kontrol di Galeri menyimpang dari nilai X atau Y yang diharapkan, saat Anda tidak memperhitungkan ukuran templat.
5. Jika Anda membuat aplikasi secara otomatis dari data, simpan aplikasi, lalu buka kembali, galeri telusuri mungkin tidak segera menampilkan data apa pun. Untuk mengatasi masalah ini, ketik setidaknya satu karakter di kotak pencarian, lalu hapus teks yang Anda ketik. Galeri kemudian akan menampilkan data seperti yang diharapkan.
6. Jika galeri menyertakan kontrol ComboBox, DatePicker, Slider, atau Toggle dengan aturan yang menambal sumber data atau koleksi yang sama dengan OnChange galeri, itu dapat menyebabkan performa yang tidak terduga atau berkurang. Ini karena OnChange aturan yang menambal sumber data galeri dapat membuat siklus patching dan pengisian ulang yang tidak pernah berakhir. Untuk menghindari masalah ini, disarankan untuk tidak menggunakan OnChange aturan ketika kontrol ini ditempatkan dalam galeri.

Properti kunci

Default – Item atau rekaman dari sumber data yang akan dipilih di galeri saat aplikasi dimulai.

Item – Sumber data yang muncul dalam kontrol seperti galeri, daftar, atau bagan.

Dipilih – Item yang dipilih.

Properti tambahan

AccessibleLabel – Label galeri (bukan item yang ada di dalamnya) untuk pembaca layar. Harus menjelaskan daftar item tersebut.

AllItems – Item yang dimuat di galeri. Ini mungkin kurang dari jumlah aktual Item sumber data. Item lainnya mungkin dimuat saat galeri digulir. AllItems juga berisi kontrol yang digunakan di setiap item galeri.

AllItemsCount - Jumlah item yang dimuat di galeri. Ini mungkin kurang dari jumlah aktual Item sumber data. Item lainnya mungkin dimuat saat galeri digulir.

BorderColor – Warna batas kontrol.

BorderStyle – Apakah batas kontrol Solid, Dashed, Dotted, atau None.

BorderThickness – Ketebalan batas kontrol.

DelayItemLoading - Tunda pemuatan item (baris) hingga setelah layar dimuat terlebih dahulu.

DisplayMode – Apakah kontrol mengizinkan input pengguna (Edit), hanya menampilkan data (Tampilan), atau dinonaktifkan (Dinonaktifkan).

Isi – Warna latar belakang kontrol.

Tinggi – Jarak antara tepi atas dan bawah kontrol.

ItemAccessibleLabel – Label setiap item galeri untuk pembaca layar. Harus menjelaskan apa itu setiap item.

LoadingSpinner (None, Controls atau Data) - Ketika Tidak Ada, spinner tidak akan ditampilkan. Kapan Kontrol | Data, spinner akan ditampilkan saat terjadi perenderan pass yang menghasilkan baris kosong yang terlihat.

LoadingSpinnerColor - Warna isian pemintal pemuatan. Default diatur ke BorderColor.

NavigationStep – Seberapa jauh galeri menggulir jika properti ShowNavigation-nya diatur ke true dan pengguna memilih panah navigasi di salah satu akhir galeri tersebut.

Dapat dipilih – Apakah item galeri dapat dipilih. Ketika diatur ke true, pembaca layar mengidentifikasi galeri sebagai daftar yang dapat dipilih. Dan Anda memilih item dengan memilihnya. Saat diatur ke false, pembaca layar mengidentifikasi galeri sebagai daftar biasa, dan memilih item tidak memilihnya.

ShowNavigation – Apakah panah muncul di setiap akhir galeri sehingga pengguna dapat menggulir item di galeri dengan memilih panah.

ShowScrollbar – Apakah bilah gulir muncul saat pengguna mengarahkan mouse ke galeri.

TemplateFill – Warna latar belakang galeri.

TemplatePadding – Jarak antar item di galeri.

TemplateSize – Tinggi templat untuk galeri dalam orientasi vertikal/potret. Atau lebar templat untuk galeri dalam orientasi horizontal/lanskap. Ukuran minimum adalah satu.

Transisi – Efek visual (Pop, Push, atau None) saat pengguna mengarahkan mouse ke atas item di galeri.

Terlihat – Apakah kontrol muncul atau disembunyikan.

Lebar – Jarak antara tepi kiri dan kanan kontrol.

WrapCount – Jumlah item yang ditampilkan per baris atau kolom berdasarkan tata letak horizontal atau vertikal.

X – Jarak antara tepi kiri kontrol dan tepi kiri kontainer atau layar induknya.

Y – Jarak antara tepi atas kontrol dan tepi atas kontainer atau layar induk.

Fungsi terkait

Filter( Sumber Data, Rumus )

Reset( Control ) - Mengatur ulang galeri Anda kembali ke status awalnya. Status awal mencakup pengguliran ke item pertama dan memilih item pertama atau default jika ada.

Nota

Kontrol reset tidak secara rekursif mengatur ulang semua turunan galeri.

Examples

Perlihatkan dan filter data

• Perlihatkan teks
• Perlihatkan gambar
• Memfilter data dengan memilih opsi daftar
• Memfilter data dengan menyesuaikan penggelser

Mendapatkan data dari pengguna

• Dapatkan teks
• Mendapatkan gambar
• Dapatkan foto
• Mendapatkan suara
• Mendapatkan gambar

Panduan aksesibilitas

Kontras warna

Jika mengklik di mana saja dalam item galeri dimaksudkan untuk memilihnya, harus ada kontras warna yang memadai antara:

• BorderColor dan warna di luar galeri (jika ada batas).
• Isi dan warna di luar galeri (jika tidak ada batas).

Dukungan pembaca layar

• AccessibleLabel harus ada.

  Nota

  Pembaca layar akan mengumumkan kapan item dalam galeri berubah. AccessibleLabel juga disebutkan. Ini memberikan konteks pada pengumuman dan bahkan lebih penting ketika ada beberapa galeri di layar yang sama.

• Saat item galeri berisi beberapa kontrol, gunakan ItemAccessibleLabel untuk menampilkan konten item galeri.

• Atur nilai Dapat Dipilih ke true jika Anda ingin pengguna memilih item galeri. Jika tidak, atur nilai tersebut ke false.

• Saat item galeri berisi beberapa kontrol, gunakan ItemAccessibleLabel untuk memberikan ringkasan konten item galeri.

• Dapat dipilih harus diatur dengan tepat, tergantung pada apakah pengguna dimaksudkan untuk memilih item galeri.

Dukungan keyboard

• Pertimbangkan untuk mengatur ShowScrollbar ke true. Di sebagian besar perangkat layar sentuh, bilah gulir tidak akan ditampilkan hingga pengguliran dimulai.

• Jika mengklik di mana saja dalam item galeri dimaksudkan untuk memilihnya, harus ada juga cara bagi pengguna keyboard untuk memilih item galeri. Misalnya, menambahkan Tombol yang memiliki properti OnSelect-nya diatur ke Select(Parent).

  Nota

  Kontrol di luar galeri tidak dipertimbangkan dalam urutan navigasi keyboard dalam galeri. Kontrol TabIndex di dalam galeri terlingkup. Lihat properti aksesibilitas untuk mempelajari selengkapnya.

Lihat juga

Gunakan spinner DelayItemLoading dan Loading untuk meningkatkan performa di Galeri