Properti komponen kanvas (eksperimental)

Artikel
06/23/2023

Komponen kanvas memungkinkan pembuat membuat berbagai jenis properti untuk menyampaikan nilai atau logika antara komponen dan aplikasi yang menghosting komponen. Properti adalah bagian penting dalam membuat komponen interaktif dan dapat digunakan kembali.

Penting

Ini adalah fitur eksperimental.
Fitur eksperimental tidak dibuat untuk penggunaan produksi dan mungkin memiliki fungsionalitas yang dibatasi. Fitur ini tersedia sebelum rilis resmi agar pelanggan bisa memperoleh akses awal dan memberikan tanggapan. Informasi lebih lanjut: Fitur eksperimental dan pratinjau
Perilaku yang dijelaskan di artikel ini hanya tersedia bila fitur eksperimental properti komponen yang disempurnakan di Pengaturan > Fitur mendatang > eksperimental diaktifkan (nonaktif secara default).
Umpan balik Anda sangat berharga bagi kami - beri tahu kami pendapat Anda di Power Apps forum komunitas fitur eksperimental.

Jenis properti

Ada empat jenis properti yang tersedia untuk pembuat:

Properti data: Properti data berkaitan dengan data, seperti warna atau nilai teks. Properti Data dapat diatur menjadi Input atau Output, yang menunjukkan apakah komponen menyediakan data ke aplikasi (Output) atau aplikasi menyediakan data ke komponen (Input). Properti data adalah satu-satunya properti yang berpartisipasi dalam alur data aplikasi.
Properti fungsi: Properti fungsi terkait dengan logika, seperti melakukan perhitungan berdasarkan parameter tertentu atau mengubah teks. Properti Fungsi dapat diatur menjadi Input atau Output, yang menunjukkan apakah komponen menyediakan fungsi yang dapat dipanggil aplikasi (Output), atau aplikasi menyediakan fungsi yang dapat dipanggil komponen (Input). Properti fungsi tidak berpartisipasi dalam aliran data aplikasi, dan tidak dapat menggunakan komponen atau variabel aplikasi.
Properti tindakan: Properti tindakan adalah jenis properti yang berhubungan dengan logika dan berperilaku seperti Fungsi Output ·. Dengan demikian, komponen memiliki logika yang ditentukan, dan logika itu dapat menggunakan ekspresi berantai dan memanipulasi koleksi atau variabel ("perilaku"). Misalnya, Clear() properti Action dapat menyediakan fungsionalitas yang dapat dipanggil aplikasi untuk menghapus beberapa nilai dalam komponen, atau Save() properti Action yang memperbarui sumber data.
Properti peristiwa: Properti peristiwa adalah kategori properti yang melibatkan logika dan fungsi sebagai Fungsi Input ·. Dengan demikian, aplikasi mendefinisikan logika, yang dapat dipanggil komponen dan logika itu dapat menggunakan ekspresi berantai dan memanipulasi koleksi atau variabel ("perilaku"). Biasanya nama properti ini mencerminkan peristiwa seperti OnSelect atau OnChanged.

Properti data

Penggunaan properti data mudah dibayangkan. Kontrol standar di aplikasi biasanya memiliki beberapa properti data, untuk menetapkan nilai default, warna teks, ukuran, dll. Mari kita lihat contoh sederhana di mana kita ingin membuat properti kontrol dalam komponen tersedia untuk aplikasi hosting. Dalam contoh ini, komponen kita diberi nama Component1. Kami akan menempatkan kontrol slider di dalam komponen kami. Kami akan memiliki properti Input untuk menentukan warna dari aplikasi yang dikonsumsi, dan properti Output di mana komponen dapat memberi tahu aplikasi apa nilai slider saat ini. Contoh berikut mengasumsikan komponen Anda berisi kontrol Slider bernama Slider.

Di panel properti komponen, pilih Properti kustom baru.
Pada panel Properti kustom baru, masukkan nama tampilan Slider Color.
Pilih Jenis properti Data dan pilih Input nilai definisi properti.
Terakhir, dari dropdown Jenis data, pilih Warna.
Klik Buat.

Selanjutnya, pilih Slider1 kontrol Penggeser . Temukan properti ValueFill dan di bilah rumus, enter. Component1.SliderColor Component1 mengacu pada nama komponen kita, dan SliderColor merupakan nama properti yang kita tambahkan sebelumnya.

Sekarang komponen kita memiliki properti yang SliderColor dapat diatur dalam aplikasi konsumsi, untuk meneruskan warna ke dalam komponen untuk mengatur properti ValueFill slider .

Kami juga ingin memberikan nilai slider ke aplikasi yang dikonsumsi. Untuk mencapai ini, kita akan menambahkan properti Output .

Di panel properti komponen, pilih Properti kustom baru.
Pada panel Properti kustom baru, masukkan nama tampilan Slider Value.
Pilih Jenis properti Data dan pilih Nilai definisi properti Output.
Terakhir, dari dropdown Jenis data, pilih Angka.
Klik Buat.

Saat properti Data adalah Output, komponen memberikan nilai ke aplikasi yang dikonsumsi. Untuk mengatur rumus untuk ini, kita perlu mengatur properti baru SliderValue di komponen ke properti Value slider.

Di panel properti komponen, klik properti Slider Value .
Di bilah rumus, ganti nilai 100 default dengan rumus berikut: Slider1.Value.

Sekarang properti komponen SliderValue kita akan mencerminkan nilai slider di dalam komponen, yang kemudian dapat dibaca dari aplikasi yang dikonsumsi.

Properti fungsi

Properti fungsi berisi ekspresi yang mengembalikan nilai. Biasanya, fungsi ini mengambil beberapa argumen yang digunakannya untuk menghitung atau menentukan nilai yang akan dikembalikan.

Catatan

Properti fungsi saat ini tidak dapat mengakses variabel atau nilai dan properti komponen, dan tidak dapat memicu aliran data. Setiap nilai yang diperlukan harus diteruskan sebagai argumen.

Fungsi Output adalah cara sederhana untuk membuat fungsi kustom untuk Power Apps. Komponen mendefinisikan fungsi Output dengan ekspresi yang mengambil beberapa argumen dan mengembalikan nilai. Fungsi ini kemudian dapat digunakan dalam aplikasi menggunakan nama komponen (katakanlah Component1) dengan menelepon Component1.MyFunction(arg1, arg2).

Fungsi Input adalah cara bagi aplikasi yang sedang mengonsumsi untuk memberikan logika ke komponen, mirip dengan penunjuk fungsi atau fungsi panggilan balik. Misalnya, komponen Anda mungkin berurusan dengan nama orang dan memiliki fungsi input dengan argumen firstname dan lastname dan menghormati string kembali. Aplikasi dapat menentukan ekspresi fungsi untuk dikembalikan $"{firstname} {lastname}" atau dapat memilih untuk menentukan ekspresi untuk $"{lastname}, {firstname}". Komponen hanya dapat memanggil fungsi yang disediakan pembuat aplikasi, dan menggunakan string yang dikembalikan.

Properti tindakan

Properti tindakan mirip dengan properti fungsi tipe Output, tetapi memungkinkan rumus efek samping, dan rantai ekspresi. Komponen dapat memiliki properti tindakan bernama AddRecord yang memungkinkan aplikasi menambahkan rekaman ke koleksi di dalam komponen, atau tindakan yang Reset menghapus variabel atau koleksi di dalam komponen.

Dalam contoh contoh slider yang digunakan untuk properti Data sebelumnya, kita dapat memperkenalkan properti tindakan yang dipanggil ResetValue untuk mengatur slider kembali ke nilai defaultnya. Kita bisa menggunakan rumus Reset( Slider1 ) untuk ini. Sekarang, contoh komponen kita di aplikasi dapat memanggil Component1.ResetValue() untuk mengatur slider kembali ke nilai default.

Properti acara

Ada banyak properti tipe Peristiwa umum, properti fungsi perilaku input yang efektif, dalam kontrol standar. OnSelect pada kontrol tombol adalah contoh yang paling jelas. Komponen dapat mendefinisikan sejumlah properti peristiwa, dan memanggil peristiwa ini seperti fungsi. Misalnya, komponen yang memiliki kontrol tombol dapat memiliki properti peristiwa bernama OnButtonClicked. Di OnSelect kontrol tombol, komponen dapat memanggil propertinya Component1.OnButtonClicked() . Aplikasi yang dikonsumsi kemudian dapat menentukan logikanya sendiri untuk properti ini, untuk bertindak ketika tombol di dalam komponen ditekan.

Nilai default untuk properti atau argumen

Nilai default dapat memberikan nilai default untuk argumen atau properti jika tidak ada yang disetel. Ini tidak masuk akal untuk beberapa jenis properti. Namun, dalam beberapa kasus mereka dapat digunakan untuk menyediakan skema yang diharapkan untuk catatan. Dengan menyediakan rekaman default, jenis rekaman ditetapkan sebagai skema yang diharapkan.

Misalnya, properti Tindakan bernama AddRecord menerima rekaman untuk ditambahkan ke koleksi lokal. Untuk menyediakan skema rekaman yang diharapkan, pembuat harus menambahkan nilai default untuk argumen properti ini AddRecord .

Bagikan melalui