Peristiwa dalam borang dan grid dalam apl dipacu model

Peristiwa dalam borang dan grid memulakan semua kod sisi klien dalam aplikasi berasaskan model. Anda mengaitkan fungsi tertentu dalam perpustakaan JavaScript (sumber web Skrip) untuk dilaksanakan apabila sesuatu peristiwa berlaku. Fungsi ini dipanggil pengendali peristiwa. Setiap pengendali peristiwa menentukan satu fungsi dalam perpustakaan JavaScript dan sebarang parameter yang boleh dihantar kepada fungsi tersebut.

Anda boleh mengaitkan pengendali acara hanya kepada beberapa acara dengan menggunakan antara muka pengguna. Untuk acara yang anda tidak boleh kaitkan melalui UI, Client API menyediakan kaedah yang boleh anda gunakan untuk melampirkan pengendali acara.

Tambah atau buang fungsi pengendali acara dalam borang menggunakan antara muka pengguna

Untuk menambah atau membuang fungsi pengendali acara bagi acara dalam Antara Muka Bersatu yang baru:

  1. Pergi ke Power Apps.

  2. Dalam anak tetingkap navigasi kiri, pilih Data dan kemudian pilih Jadual.

  3. Daripada senarai jadual, pilih jadual di mana anda mahu menambah pengendali peristiwa.

  4. Pilih tab Borang dari bar arahan dan kemudian pilih borang di mana anda ingin menambah pengendali acara.

    Tangkapan skrin tab Borang yang menunjukkan senarai borang untuk jadual dalam Power Apps.

  5. Pilih tab Acara . Anda akan melihat kedua-dua pengendali acara On Save dan On Load .

    Tangkapan skrin tab Acara yang menunjukkan pengendali acara borang On Save dan On Load.

  6. Untuk menambah pengendali acara bagi acara perubahan, pilih lajur dan kemudian pilih tab Acara .

    Tangkapan skrin tab Acara lajur yang menunjukkan tetapan pengendali acara On Change.

Borang suntingan pukal

Secara lalai, pengendali acara tidak berjalan apabila borang berada dalam mod suntingan pukal.

Untuk mengaktifkan pengendali acara dalam mod suntingan pukal, ubah XML Borang dengan mencari elemen yang berkaitan event dan mencipta atau menetapkan BehaviorInBulkEditForm atribut kepada Enabled. Pada masa ini, tingkah laku ini hanya disokong untuk acara OnLoad.

Untuk maklumat lanjut tentang penyesuaian XML Borang, lihat Bila hendak mengedit fail penyesuaian, Sesuaikan borang, dan skema XML Borang.

Untuk menentukan bila pengendali acara dijalankan pada borang dalam mod suntingan pukal, gunakan kaedah ini getFormType .

Tambah atau buang fungsi pengendali acara menggunakan kod API Klien

Gunakan kaedah berikut untuk menambah dan mengeluarkan pengendali acara bagi acara yang anda tidak boleh kaitkan melalui antara muka pengguna:

Peristiwa Pengendali acara
Atribut OnChange addOnUbah dan removeOnChange kaedah
Borang OnLoad formContext.ui addOnLoad dan removeOnLoad kaedah
Borang Dimuatkan formContext.ui addLoaded dan removeLoaded kaedah
Data borang OnLoad formContext.data addOnLoad dan kaedah removeOnLoad
Borang OnSave kaedah addOnSave dan removeOnSave
PraCarian kawalan carian addPreSearch dan removePreSearch kaedah
kbsearch kawalan OnResultOpened addOnResultOpened dan removeOnResultOpened
kbsearch kawalan OnSelection addOnSelection dan kaedah removeOnSelection
kbsearch kawalan PostSearch addOnPostSearch dan kaedah removeOnPostSearch

Penting

Konteks pelaksanaan secara automatik dihantar sebagai parameter pertama kepada fungsi yang anda tetapkan menggunakan kod tersebut. Untuk maklumat lanjut, lihat Konteks pelaksanaan API Klien.

Saluran paip acara borang

Anda boleh mentakrifkan sehingga 50 pengendali peristiwa untuk setiap acara. Bahagian Pengendali Acara dalam tab Peristiwa dalam kotak dialog Sifat Borang menunjukkan susunan pengendali acara, dan setiap pengendali acara dijalankan mengikut susunan tersebut.

Gunakan kaedah setSharedVariable dan getSharedVariable untuk menghantar pembolehubah biasa antara pengendali peristiwa (fungsi). Gunakan kaedah konteks pelaksanaan getDepth untuk memahami urutan pelaksanaan pengendali acara berbanding pengendali acara lain.

Fahami model objek API Pelanggan
Konteks pelaksanaan API pelanggan
Peristiwa (rujukan API Klien)

  • Kali terakhir dikemas kini pada