Kontrol galeri di Power Apps

Kontrol yang berisi kontrol lain dan menampilkan kumpulan data.

KETERANGAN

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

Setiap bidang data muncul di kontrol terpisah dalam kontrol Galeri. Dan Anda dapat mengonfigurasi kontrol tersebut di 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 akan tercermin di seluruh kontrol Galeri.

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

Pembatasan

Kontrol galeri memiliki batasan ini:

1. Jika pengguna menggulir kontrol galeri Tinggi fleksibel sebelum semua item dimuat, item yang sedang ditampilkan dapat didorong ke bawah dan keluar dari tampilan saat pemuatan data selesai. Untuk menghindari masalah ini, gunakan kontrol Galeri standar dan bukan varian Tinggi fleksibel.
2. Kontrol berikut ini tidak didukung di dalam galeri:
   • Display form
   • Formulir pengeditan
   • Penampil PDF
   • Power BI lain
   • Rich text editor
   • Layar yang dapat di-scroll (Kisi cair)
   • Pemindai kode batang web
3. Anda hanya dapat menambahkan satu galeri di dalam galeri lain.
4. TemplateSize minimum adalah satu. Hal ini dapat menyebabkan kontrol di Galeri menyimpang dari nilai X atau Y yang diharapkan, saat Anda tidak memperhitungkan ukuran template.
5. Jika Anda membuat aplikasi secara otomatis dari data, menyimpan aplikasi, lalu membukanya kembali, jelajahi galeri mungkin tidak langsung menampilkan data apa pun. Untuk mengatasi masalah ini, ketik minimal satu karakter di kotak pencarian, kemudian hapus teks yang Anda ketik. Galeri kemudian akan menampilkan data seperti yang diharapkan.

Properti kunci

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

Items – Sumber data yang muncul di kontrol, seperti galeri, daftar, atau diagram.

Terpilih - Hilangkan item yang dipilih.

Properti tambahan

AccessibleLabel – Label dari galeri (bukan item yang dikandungnya) untuk pembaca layar. Harus menjelaskan daftar item.

AllItems – Item yang dimuat di galeri. Ini mungkin kurang dari jumlah sebenarnya Item sumber data. Lebih banyak item dapat 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 sebenarnya Item sumber data. Lebih banyak item dapat dimuat saat galeri digulir.

BorderColor – Warna batas kontrol.

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

BorderThickness – Ketebalan batas kontrol.

DelayItemLoading - Menunda pemuatan item (baris) sampai setelah layar dimuat pertama kali.

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

Fill – Warna latar belakang kontrol.

Height – Jarak antara tepi atas dan bawah kontrol.

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

LoadingSpinner (Tidak Ada, Kontrol atau Data) - Saat Tidak Ada, spinner tidak akan ditampilkan. Jika Kontrol | Data, pemutar akan ditampilkan saat render pass terjadi yang mengakibatkan tampaknya baris kosong.

LoadingSpinnerColor - Warna isi spinner pemuatan. Secara default diatur ke BorderColor.

NavigationStep – Mengatur cara galeri bergulir, jika properti ShowNavigation diatur ke true dan pengguna memilih panah navigasi pada ujung mana pun dari galeri tersebut.

Selectable – Mengatur apakah item galeri dapat dipilih. Saat 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 akan memilihnya.

ShowNavigation – Mengatur apakah panah muncul di setiap ujung galeri supaya pengguna dapat menggulir item dalam galeri dengan memilih panah.

ShowScrollbar – Mengatur apakah bilah gulir akan muncul saat pengguna mengarahkan kursor ke atas galeri.

TemplateFill – Warna latar belakang galeri.

TemplatePadding – Jarak antara item di galeri.

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

Transition – Efek visual (Pop, Dorong, atau Tidak Ada) saat pengguna mengarahkan kursor ke atas item dalam galeri.

Visible – Mengatur apakah kontrol akan muncul atau tersembunyi.

Width – 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 wadah induknya atau layar.

Y – Jarak antara tepi atas kontrol dan tepi atas wadah induknya atau layar.

Fungsi terkait

Filter( DataSource, Formula )

Reset( Control ) - Mereset galeri Anda kembali ke status awalnya. Status awal meliputi menggulir ke item pertama dan memilih item pertama atau default, jika ada.

Catatan

Reset kontrol tidak mereset semua anak galeri secara berulang.

Contoh

Menampilkan dan memfilter data

• Menampilkan teks
• Menampilkan gambar
• Memfilter data dengan memilih opsi daftar
• Memfilter data dengan menyesuaikan penggeser

Mendapatkan data dari pengguna

• Mendapatkan teks
• Mendapatkan gambar
• Mendapatkan foto
• Mendapatkan suara
• Mendapatkan hasil menggambar

Panduan aksesibilitas

Kontras warna

Jika mengeklik di mana pun dalam item galeri berarti memilihnya, maka harus ada kontras warna yang memadai antara:

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

Dukungan pembaca layar

• AccessibleLabel harus ada.

  Catatan

  Pembaca layar akan mengumumkan, jika item di galeri berubah. Accessiblelabel juga disebutkan. Hal ini memberikan konteks untuk pengumuman dan bahkan lebih penting, jika ada beberapa galeri pada layar yang sama.

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

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

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

• Selectable harus diatur dengan benar, tergantung pada apakah pengguna dimaksudkan untuk memilih item galeri.

Dukungan keyboard

• Pertimbangkan untuk mengatur ShowScrollbar ke true. Pada sebagian besar perangkat layar sentuh, bilah gulir tidak akan muncul sampai pengguliran dimulai.

• Jika mengeklik di mana pun dalam item galeri berarti memilihnya, harus ada juga cara bagi pengguna keyboard untuk memilih item galeri. Misalnya, menambahkan Button dengan properti OnSelect yang diatur ke Select(Parent).

  Catatan

  Kontrol di luar galeri tidak dipertimbangkan dalam urutan navigasi keyboard dalam galeri. Kontrol TabIndex dalam galeri telah tercakup. Lihat properti aksesibilitas untuk mempelajari lebih lanjut.

Lihat juga

Gunakan DelayItemLoading dan Loading spinner untuk meningkatkan kinerja di Galeri

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).