Bagikan melalui

elemen kontrol

Menentukan namespace, versi, dan informasi tampilan komponen.

Tersedia untuk

Aplikasi berbasis model dan kanvas

Parameter-parameternya

Nama Description Tipe Diperlukan Tersedia untuk
namespace Menentukan prototipe objek komponen Hanya huruf atau angka Yes Aplikasi berbasis model dan kanvas
constructor Metode untuk menginisialisasi objek Hanya huruf atau angka Yes Aplikasi berbasis model dan kanvas
control-type Apakah kontrol adalah kontrol standar atau kontrol React. Nilai virtual menunjukkan kontrol React menggunakan pustaka React platform. Kontrol virtual adalah fitur dalam pratinjau publik. Informasi selengkapnya: Kontrol react & pustaka platform standard|virtual Tidak. Aplikasi berbasis model dan kanvas
description-key Menentukan deskripsi komponen yang terlihat di UI. string Tidak. Aplikasi berbasis model dan kanvas
display-name-key Menentukan nama kontrol yang terlihat di UI. string Yes Aplikasi berbasis model dan kanvas
preview-image Gambar yang digunakan pada layar kustomisasi untuk menampilkan pratinjau komponen. string Tidak. Aplikasi yang diarahkan model
version Menentukan versi komponen yang ditentukan dalam Penerapan Versi Semantik string Yes Aplikasi berbasis model dan kanvas

Elemen Induk

Elemen Description
Mewujudkan Manifes adalah file metadata yang menentukan komponen. Ini adalah XML file yang menjelaskan:
  • Namespace komponen.
  • Jenis data yang dapat dikonfigurasi, baik bidang atau himpunan data.
  • Properti apa pun yang dapat dikonfigurasi dalam aplikasi saat komponen ditambahkan.
  • Daftar file sumber daya yang dibutuhkan komponen.
    • Salah satunya harus berupa sumber daya web TypeScript. TypeScript ini harus menyertakan fungsi yang akan membuat instans objek. Ini mengimplementasikan antarmuka yang mengekspos metode yang diperlukan agar komponen berfungsi. Ini disebut pustaka implementasi komponen.
  • Nama fungsi TypeScript di pustaka implementasi komponen yang akan mengembalikan objek yang menerapkan antarmuka komponen yang diperlukan.
Saat pengguna mengonfigurasi komponen kustom dalam aplikasi kanvas atau aplikasi berbasis model, data dalam manifes memfilter komponen yang tersedia sehingga hanya komponen yang valid untuk konteks yang tersedia untuk konfigurasi. Properti yang ditentukan dalam manifes untuk komponen dirender sebagai bidang konfigurasi sehingga pengguna yang mengonfigurasi komponen dapat menentukan nilai. Nilai properti ini kemudian tersedia untuk fungsi komponen pada waktu proses.

Elemen Anak

Elemen Description Kejadian
himpunan data Simpul himpunan data dalam manifes komponen mewakili representasi tertentu yang dapat dikonfigurasi dari sekumpulan rekaman tabel. 0 atau lebih
penggunaan layanan eksternal Menunjukkan apakah kontrol ini menggunakan layanan eksternal atau tidak. Jika ya, atur bendera atribut yang diaktifkan sebagai true dan tambahkan domain layanan eksternal ke <domain> properti . Kontrol yang menggunakan layanan eksternal apa pun adalah kontrol premium dan pengguna akhir akan memerlukan lisensi Power Apps untuk membuka aplikasi dengan kontrol premium. Informasi selengkapnya: Lisensi 0 atau 1
harta benda Simpul properti mendefinisikan bagian data tertentu yang dapat dikonfigurasi yang diharapkan komponen dari Microsoft Dataverse. 0 atau lebih
sumber daya Simpul sumber daya dalam manifes komponen mengacu pada file sumber daya yang diperlukan komponen untuk mengimplementasikan visualisasinya. 1
jenis grup Simpul grup jenis menentukan sekumpulan jenis yang diidentifikasi dengan satu nama. Informasi ini dapat digunakan untuk mengidentifikasi jenis data yang didukung oleh properti tertentu. 0 atau lebih
dependensi properti Menentukan sekelompok dependensi properti. 0 atau lebih
tindakan platform Digunakan untuk menentukan bahwa dependensi kontrol memuat sesuai permintaan alih-alih ketika kontrol dimuat. 0 atau 1

Example

<control namespace="MyNameSpace"
   constructor="JSHelloWorldControl"
   version="1.0.0"
   display-name-key="JS_HelloWorldControl_Display_Key"
   description-key="JS_HelloWorldControl_Desc_Key"
   control-type="standard"
   preview-image="img/preview.png">
</control>

Referensi skema manifes kerangka kerja komponen Power Apps
Referensi API kerangka kerja komponen Power Apps
Gambaran umum kerangka kerja komponen Power Apps

  • Last updated on