Bagikan melalui

Kontrol Kartu di Power Apps

  • Artikel

Menyediakan pengalaman tampilan dan pengeditan untuk bidang tunggal kontrol Display form atau Edit form.

KETERANGAN

Kontrol Display form dan Edit form bertindak sebagai wadah untuk menampilkan dan melihat seluruh rekaman. Setiap wadah dapat memegang serangkaian kontrol Kartu yang menampilkan masing-masing bidang atau menyediakan cara untuk memperbarui bidang tersebut. Setiap kartu memiliki properti DataField yang menetapkan bidang mana dari rekaman yang berfungsi dengannya.

Kartu yang sudah ditentukan akan ditentukan untuk berbagai jenis data dan pengalaman pengguna. Misalnya, mungkin ada kartu untuk mengedit bidang angka dengan kontrol Text input yang sangat bagus untuk digunakan dengan keyboard. Kartu lain mungkin mendukung pengeditan angka dengan menggunakan kontrol Slider. Dengan kontrol formulir terpilih, Anda dapat memilih kartu berdasarkan bidang dengan mudah di panel kanan.

Kartu itu sendiri berisi kontrol. Kontrol kartu membuat pengalaman untuk menampilkan dan mengedit satu bidang. Misalnya, kartu angka dapat berisi kontrol Label untuk menyediakan nama tampilan bidang dan kontrol Text input untuk menyediakan editor nilai bidang. Kartu juga dapat memiliki kontrol Label yang menunjukkan kesalahan validasi yang terjadi dan kontrol Label untuk tanda bintang umum yang menunjukkan bahwa bidang diperlukan.

Anda dapat menyesuaikan kontrol kartu yang telah ditentukan dengan mengubah ukurannya, memindahkannya, menyembunyikannya, menambahkan kontrol, dan membuat perubahan lain. Anda juga dapat memulai dengan kartu yang kosong seluruhnya, yaitu "kartu kustom" yang akan Anda tambahkan dengan kontrol dari awal.

Kartu yang telah ditentukan akan terkunci secara default. Di kartu yang terkunci, Anda hanya dapat memodifikasi properti tertentu dari kartu atau kontrol dalam kartu dan Anda tidak dapat menghapus kartu yang terkunci. Anda dapat menampilkan kunci kartu dan membukanya di tab Tampilan dari tampilan Lanjutan. Jika properti terkunci dan tidak dapat dimodifikasi, maka properti tersebut akan ditampilkan dengan ikon gembok di sebelah namanya. Membuka kunci kartu adalah aktivitas lanjutan dan harus dilakukan dengan hati-hati, karena pembuatan rumus otomatis tidak lagi berlaku untuk kartu tersebut dan Anda tidak dapat mengunci kartu lagi.

Dalam wadah formulir, rekaman ThisItem tersedia dan berisi semua bidang rekaman. Misalnya, properti Default kartu sering diatur ke ThisItem.FieldName.

Anda dapat menggunakan referensi Parent untuk mengonfigurasi kontrol untuk merujuk properti sebuah kartu. Misalnya, kontrol harus menggunakan Parent. Default untuk membaca keadaan awal bidang dari sumber data. Dengan menggunakan Parent dan bukan secara langsung mengakses informasi yang Anda inginkan, kartu akan dienkapsulasi dengan lebih baik dan Anda dapat mengubahnya menjadi bidang yang berbeda tanpa merusak rumus internal.

Lihat Memahami kartu data untuk contoh cara menyesuaikan, membuka, dan membuat kartu.

Properti utama

DataField – Nama bidang dalam rekaman yang menampilkan dan mengedit kartu ini.

  • Tetapkan nama sebagai satu string statis yang diberi tanda kutip ganda (misalnya, "Nama"), bukan rumus.
  • Batalkan ikatan kartu dengan mengatur properti DataField menjadi kosong. Properti Valid dan Update diabaikan untuk kartu yang tidak terikat.

Default – Nilai awal kontrol sebelum pengguna mengubahnya.

  • Untuk setiap kontrol dalam sebuah kartu, atur properti ini ke Parent.Default untuk merujuk ke nilai default bidang sesuai dengan sumber data. Misalnya, atur properti Default penggeser ke Parent.Default untuk memastikan bahwa pengguna memulai dengan nilai umum untuk penggeser tersebut.

DisplayMode – Nilai dapat Diedit, Dilihat, atau Dinonaktifkan. Mengonfigurasi apakah kontrol di dalam kartu memungkinkan pengguna untuk menginput (Edit), hanya menampilkan data (Tampilan), atau dinonaktifkan (Nonaktif).

  • Memungkinkan satu kartu untuk digunakan di formulir edit dan tampilan dengan mengonfigurasi properti ini yang terikat dengan perilaku Formulir secara default.
  • Pada mode Tampilan, kontrol anak seperti Text input, Drop down, atau Date Picker hanya akan menampilkan nilai teks dan tidak akan menampilkan elemen atau dekorasi interaktif.

DisplayName – Nama yang mudah bagi pengguna untuk sebuah bidang dalam sumber data.

  • Fungsi DataSourceInfo menyediakan metadata ini dari sumber data.
  • Kontrol dalam kartu harus menggunakan Parent.DisplayName untuk merujuk nama bidang.

Error – Pesan kesalahan yang ramah pengguna untuk bidang ini saat validasi gagal.

  • Properti ini diatur saat SubmitForm diminta.
  • Pesan ini menjelaskan masalah validasi berdasarkan metadata sumber data dan memeriksa properti Required dari kartu.

Required – Mengatur apakah kartu yang mengedit bidang sumber data harus berisi nilai.

  • Fungsi DataSourceInfo menyediakan metadata yang diperlukan dari sumber data.
  • Kontrol dalam kartu harus menggunakan Parent.Required untuk menentukan apakah bidang kartu diperlukan.

Update – Nilai untuk menulis kembali ke sumber data untuk sebuah bidang.

  • Gunakan rumus properti ini untuk menarik nilai dari kontrol edit kartu untuk menulis kembali ke sumber data. Misalnya, atur properti Update kartu ke Slider.Value untuk memperbarui sumber data dengan nilai dari penggeser dalam kartu tersebut.

Width – Jarak antara tepi kiri dan kanan kontrol.

WidthFit – Mengatur apakah kontrol secara otomatis meluas secara horizontal untuk mengisi ruang kosong dalam kontrol wadah, seperti Edit form. Jika beberapa kartu memiliki properti ini diatur ke benar, ruang dibagi antara mereka. Untuk informasi lebih lanjut, lihat Memahami tata letak formulir data.

Properti tambahan

BorderColor – Warna batas kontrol.

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

BorderThickness – Ketebalan batas kontrol.

Fill – Warna latar belakang kontrol.

Height – Jarak antara tepi atas dan bawah kontrol.

Valid – Mengatur apakah kontrol Kartu atau Edit form berisi entri valid yang siap dikirim ke sumber data.

Visible – Mengatur apakah kontrol akan muncul atau tersembunyi.

X – Jarak antara tepi kiri kontrol dan tepi kiri wadah induknya (layar, jika tidak ada wadah induk). Untuk kontrol Card dalam wadah yang memiliki beberapa kolom, properti ini menentukan kolom tempat kartu ditampilkan.

Y – Jarak antara tepi atas dan tepi atas wadah induk (layar, jika tidak ada wadah induk). Untuk kontrol Card dalam wadah yang memiliki beberapa baris, properti ini menentukan baris tempat kartu ditampilkan.

Contoh

Lihat Memahami kartu data dan Memahami tata letak formulir data untuk contohnya.

Panduan aksesibilitas

Kontras warna

Harus ada kontras warna yang memadai antara:

  • Fill dan kontrol anak. Contohnya, jika kartu berisi Label dan label memiliki isi yang transparan, maka Fill secara efektif akan menjadi warna latar belakang untuk label tersebut. Dengan demikian, harus ada kontras yang memadai antara Fill kartu dan Color label.

Dukungan pembaca layar

  • DisplayName harus ada.

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