Bagikan melalui


Properti komponen kanvas

Komponen kanvas memungkinkan pembuat membuat berbagai jenis properti untuk meneruskan nilai atau logika antara komponen dan aplikasi yang menghosting komponen. Properti sangat penting untuk membangun komponen interaktif yang dapat digunakan kembali.

Prasyarat

Fitur ini aktif secara default untuk aplikasi baru. Untuk aplikasi yang ada, Anda harus mengaktifkannya di pengaturan aplikasi.

  1. Buka aplikasi kanvas Anda untuk diedit Power Apps Studio. Pada bilah perintah, pilih Pembaruan Pengaturan>.

  2. Pada tab Baru , temukan dan aktifkan pengaturan Properti komponen yang disempurnakan.

Jenis properti

Ada empat jenis properti yang tersedia untuk pembuat.

  1. 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.
  2. 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.
  3. 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 tersebut 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.
  4. 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 tersebut dapat menggunakan ekspresi berantai dan memanipulasi koleksi atau variabel ("perilaku"). Biasanya nama properti ini mencerminkan peristiwa seperti OnSelect or OnChanged.

Properti data

Penggunaan properti data mudah dibayangkan. Kontrol standar dalam aplikasi biasanya memiliki beberapa properti data, untuk mengatur nilai default, warna teks, ukuran, dll. Mari kita lihat contoh sederhana di mana Anda ingin membuat properti kontrol dalam komponen tersedia untuk aplikasi hosting. Dalam contoh ini, komponen diberi nama Component1. Letakkan kontrol penggeser di dalam komponen. Tambahkan properti Input untuk menentukan warna dari aplikasi yang mengkonsumsi, dan properti Output sehingga komponen dapat memberi tahu aplikasi nilai penggeser saat ini. Contoh ini mengasumsikan komponen memiliki kontrol Slider bernama Slider.

  1. Di panel properti komponen, pilih Properti kustom baru.
  2. Pada panel Properti kustom baru, masukkan nama Slider Color tampilan.
  3. Pilih Jenisproperti Data dan pilih Nilai definisi properti Input.
  4. Terakhir, dari dropdown Jenis data, pilih Warna.
  5. Klik Buat.

Selanjutnya, pilih Slider1kontrol Slider . Temukan properti ValueFill dan di bilah rumus, masukkan Component1.SliderColor. Component1 adalah nama komponen, dan SliderColor merupakan nama properti yang Anda tambahkan.

Sekarang komponen memiliki SliderColor properti yang dapat diatur di aplikasi yang mengonsumsi untuk meneruskan warna ke dalam komponen dan mengatur properti ValueFill penggeser .

Anda mungkin juga ingin memberikan nilai penggeser ke aplikasi yang mengkonsumsi. Untuk melakukan ini, tambahkan properti Output .

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

Saat properti Data adalah Output, komponen memberikan nilai ke aplikasi yang mengkonsumsi. Untuk mengatur rumus, atur properti baru SliderValue dalam komponen ke properti Value dari penggeser.

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

Sekarang properti komponen SliderValue mencerminkan nilai penggeser di dalam komponen, yang dapat dibaca oleh aplikasi yang mengkonsumsi.

Properti fungsi

Properti fungsi berisi ekspresi yang mengembalikan nilai. Biasanya, fungsi mengambil argumen yang digunakannya untuk menghitung 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 memanggil Component1.MyFunction(arg1, arg2).

Fungsi Input memungkinkan aplikasi yang menggunakan menyediakan logika ke komponen, mirip dengan penunjuk fungsi atau fungsi callback. Misalnya, jika komponen bekerja dengan nama orang, komponen dapat memiliki fungsi input dengan argumen firstname dan lastname mengharapkan string kembali. Aplikasi dapat menentukan ekspresi fungsi untuk dikembalikan $"{firstname} {lastname}" atau $"{lastname}, {firstname}". Komponen memanggil fungsi yang disediakan pembuat aplikasi dan menggunakan string yang ditampilkan.

Properti tindakan

Properti tindakan mirip dengan properti fungsi jenis 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 Reset tindakan yang menghapus variabel atau koleksi di dalam komponen.

Dalam contoh penggeser sebelumnya untuk properti Data, Anda dapat menambahkan properti tindakan yang dipanggil ResetValue untuk mengatur penggeser kembali ke nilai defaultnya. Gunakan rumus Reset( Slider1 ) untuk ini. Sekarang, instance komponen dalam aplikasi dapat memanggil Component1.ResetValue() untuk mengatur penggeser kembali ke nilai default.

Properti acara

Banyak kontrol standar memiliki properti tipe Peristiwa umum, yang merupakan properti fungsi perilaku input. OnSelect pada kontrol tombol adalah contoh umum. Komponen dapat menentukan properti peristiwa dan memanggil peristiwa ini seperti fungsi. Misalnya, komponen dengan kontrol tombol dapat memiliki properti peristiwa bernama OnButtonClicked. Di OnSelect kontroltombol, komponen dapat memanggil propertinya Component1.OnButtonClicked() . Aplikasi yang mengkonsumsi dapat menentukan logikanya sendiri agar properti ini bertindak saat tombol di dalam komponen ditekan.

Nilai default untuk properti atau argumen

Nilai default memberikan nilai argumen atau properti jika tidak ada yang ditetapkan. Ini tidak masuk akal untuk beberapa jenis properti. Dalam beberapa kasus, Anda dapat menggunakan nilai default untuk menampilkan skema yang diharapkan untuk rekaman. Dengan menyediakan rekaman default, Anda mengatur jenis rekaman sebagai skema yang diharapkan.

Misalnya, properti Action bernama AddRecord mengambil rekaman untuk ditambahkan ke koleksi lokal. Untuk menampilkan skema rekaman yang diharapkan, tambahkan nilai default untuk AddRecord argumen properti.