Kontrol Lampiran di Power Apps
Kontrol yang memungkinkan pengguna mengunduh file ke perangkat mereka, serta mengunggah dan menghapus file dari daftar yang dibuat dengan Microsoft Lists atau tabel Microsoft Dataverse.
Description
Kontrol Lampiran memungkinkan Anda membuka, menambah, dan menghapus file dari daftar atau tabel Dataverse.
Pembatasan
Kontrol lampiran memiliki batasan berikut:
Kontrol lampiran hanya mendukung daftar dan tabel Dataverse sebagai sumber data. Ekspresi yang mengubah sumber data ini menjadi Tabel, misalnya, dengan fungsi ForAll, tidak didukung.
Fungsi unggah dan hapus hanya berfungsi di dalam formulir. Kontrol Lampiran akan dinonaktifkan saat berada dalam mode Edit dan tidak berada di dalam formulir. Untuk menyimpan penambahan dan penghapusan file, pengguna aplikasi harus menyimpan formulir. Karena batasan ini, kontrol Lampiran tidak tersedia dari tab Sisipan, namun muncul di formulir saat bidang formulir Lampiran diaktifkan di formulir SharePoint atau Dataverse.
Kontrol lampiran di browser web memungkinkan Anda memilih beberapa file, dan memungkinkan penggunaan fungsi tarik dan lepaskan. Namun, bila menggunakan kontrol lampiran di Power Apps Mobile, Anda hanya dapat menambahkan file satu per satu.
Properti kunci
Item – Kolom Lampiran dari daftar atau tabel Dataverse. Koleksi dan Tabel tidak didukung.
MaxAttachments – Jumlah maksimum file yang akan diterima kontrol.
MaxAttachmentSize – Ukuran file maksimum yang diizinkan dalam satuan MB untuk setiap lampiran baru. 1 MB di sini adalah 1000.000 bita (106 B) atau 1.000 KB.
OnAddFile – Tindakan untuk dilakukan saat pengguna menambahkan lampiran file baru.
OnRemoveFile – Tindakan untuk dilakukan ketika pengguna menghapus lampiran yang ada.
OnUndoRemoveFile – Tindakan untuk dilakukan ketika pengguna memulihkan lampiran yang dihapus.
Properti tambahan
AccessibleLabel – Label untuk pembaca layar. Menjelaskan tentang tujuan lampiran.
AddAttachmentText – Teks label untuk tautan yang digunakan untuk menambahkan lampiran baru.
BorderColor – Warna batas kontrol.
BorderStyle – Mengatur apakah batas kontrol Solid, Putus-Putus, Bertitik, atau Tidak Ada.
BorderThickness – Ketebalan batas kontrol.
Warna – Warna teks kontrol.
DisabledBorderColor – Warna batas kontrol, jika properti DisplayMode dari kontrol diatur ke Nonaktif.
DisabledColor – Warna teks dalam kontrol, jika properti DisplayMode diatur ke Nonaktif.
DisabledFill – Warna latar belakang, jika properti DisplayMode diatur ke Nonaktif.
DisplayMode – Mengatur apakah kontrol memungkinkan penambahan dan penghapusan file (Edit), hanya menampilkan data (Tampilkan), atau dinonaktifkan (Nonaktif).
[DropTargetBackgroundColor] – Warna latar belakang target pelepasan kontrol.
[DropTargetBorderColor] – Warna tepi target pelepasan kontrol.
[DropTargetBorderStyle] - Apakah batas target pelepasan kontrol itu Solid, Putus-Putus, Bertitik, atau Tidak Ada.
[DropTargetBorderThickness] – Ketebalan tepi target pelepasan kontrol.
[DropTargetTextColor] – Warna teks target pelepasan kontrol.
Fill – Warna latar belakang kontrol.
FocusedBorderColor – Warna batas kontrol saat kontrol difokuskan.
FocusedBorderThickness – Ketebalan batas kontrol saat kontrol difokuskan.
Height – Jarak antara tepi atas dan bawah kontrol.
Font – Nama kelompok fon untuk menampilkan teks.
FontWeight – Berat teks dalam sebuah kontrol: Tebal, Semitebal, Normal, atau Ringan.
HoverBorderColor – Warna batas kontrol saat pengguna mengarahkan penunjuk mouse ke atas kontrol tersebut.
HoverColor – Warna teks dalam sebuah kontrol saat pengguna mengarahkan penunjuk mouse di atasnya.
HoverFill – Warna latar kontrol saat pengguna mengarahkan penunjuk mouse di atasnya.
Italic – Mengatur apakah teks dalam sebuah kontrol menjadi miring.
MaxAttachmentsText – Teks yang menggantikan tautan "Lampirkan file" saat kontrol berisi jumlah maksimum file yang diizinkan.
NoAttachmentsText – Teks informasi yang ditampilkan kepada pengguna saat tidak ada file yang dilampirkan.
Padding – Jarak antara teks di tombol impor atau ekspor dan tepi-tepi tombol tersebut.
PressedBorderColor – Warna batas kontrol saat pengguna memilih kontrol tersebut.
PressedColor – Warna teks dalam kontrol saat pengguna memilih kontrol tersebut.
PressedFill – Warna latar kontrol saat pengguna memilih kontrol tersebut.
Atur ulang – Mengembalikan semua perubahan ke kontrol lampiran yang dikembalikan ke status tersimpan sebelumnya.
Size – Ukuran fon teks yang muncul pada kontrol.
Strikethrough – Mengatur apakah akan muncul garis yang melalui teks yang ada pada kontrol.
TabIndex – Perintah navigasi keyboard terkait dengan kontrol lainnya.
Tooltip – Teks penjelasan yang muncul ketika pengguna mengarahkan mouse ke atas kontrol.
Underline – Mengatur apakah akan muncul garis di bawah teks yang ada pada kontrol.
Visible – Mengatur apakah kontrol dimunculkan atau tersembunyi.
Width – Jarak antara tepi kiri dan kanan kontrol.
X – Jarak antara tepi kiri kontrol dan tepi kiri wadah induknya (atau layar, jika tidak ada wadah induk).
Y – Jarak antara tepi atas dan tepi atas kontrol dan tepi atas wadah induknya (atau layar, jika tidak ada wadah induk).
Contoh
Tambahkan formulir ke aplikasi Anda dan atur daftar sebagai sumber datanya.
Pilih kontrol Tampilkan Formulir di tampilan pohon pada sisi kiri. Anda juga dapat menggunakan Edit Formulir.
Pilih Sumber Data di tab Properti dalam panel opsi di sebelah kanan, lalu pilih daftar yang tersambung dengan Anda.
Pilih Edit bidang di bagian Bidang dan pilih Tambah bidang.
Pilih bidang Lampiran dan pilih Tambah.
Bidang Lampiran yang terkait dengan daftar akan muncul di formulir.
Pelajari cara menambahkan dan mengonfigurasi kontrol
Panduan aksesibilitas
Kontras warna
Harus ada kontras warna yang memadai antara:
- ItemColor dan ItemFill
- ItemHoverColor dan ItemHoverFill
- ItemPressedColor dan ItemPressedFill
- AddedItemColor dan AddedItemFill
- RemovedItemColor dan RemovedItemFill
- ItemErrorColor dan ItemErrorFill
- AddAttachmentColor dan Fill
- MaxAttachmentsColor dan Fill
- NoAttachmentsColor dan Fill
Persyaratan ini adalah tambahan untuk persyaratan kontras warna standar.
Dukungan pembaca layar
Properti berikut harus ada:
- AccessibleLabel
- AddAttachmentsText
- MaxAttachmentsText
- NoAttachmentsText
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 kejernihan ini.
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).