Kongsi melalui

Konfigurasikan pengendali peristiwa borang aplikasi didorong model

  • Artikel

Pengendali peristiwa borang untuk borang Power Apps boleh dikonfigurasi untuk kawasan berikut dalam borang:

Elemen Peristiwa Perihalan
Borang OnLoad Berlaku apabila borang keluar.
OnSave Berlaku apabila data disimpan.
Tab TabStateChange Berlaku apabila tab berkembang atau runtuh.
Column OnChange Berlaku apabila data dalam lajur berubah dan kawalan kehilangan tumpuan.
IFRAME OnReadyStateComplete Berlaku apabila kandungan IFRAME keluar.

Pengendali peristiwa terdiri daripada rujukan kepada sumber web JavaScript dan fungsi yang ditakrifkan dalam sumber web tersebut yang akan dilaksanakan apabila berlakunya peristiwa tersebut. Setiap elemen boleh mempunyai sehingga 50 pengendali peristiwa berasingan yang dikonfigurasikan.

Penting

Mengkonfigurasi pengendali peristiwa yang salah boleh mengakibatkan kesilapan skrip yang boleh menyebabkan borang gagal untuk memuatkan atau berfungsi dengan betul. Jika anda bukan pemaju skrip tersebut, pastikan anda memahami betul-betul opsyen konfigurasi apa yang memerlukan skrip.

Jangan konfigurasi pengendali peristiwa skrip menggunakan perpustakaan yang tidak datang daripada sumber yang dipercayai. Skrip boleh digunakan untuk melaksanakan apa-apa tindakan yang pengguna mungkin lakukan dan skrip yang ditulis dengan teruk boleh merosakkan prestasi borang dengan ketara.

Selepas anda mengkonfigurasi pengendali peristiwa, sentiasa ujinya untuk mengesahkan ia berfungsi dengan betul.

Konfigurasikan pengendali peristiwa

Prosedur berikut menerangkan cara mengkonfigurasikan pengendali peristiwa untuk borang. Gunakan langkah yang serupa untuk mengkonfigurasikan pengendali peristiwa bagi tab, lajur atau IFrame.

  1. Daftar masuk ke Power Apps, buka jadual yang anda mahu, dan kemudian buka borang dalam reka bentuk borang yang anda mahu mengkonfigurasikan pengendali peristiwa.

  2. Bergantung pada keadaan pustaka, pilih daripada yang berikut:

    • Jika pustaka mengandungi fungsi yang anda mahu untuk menetapkan pengendali peristiwa sebagai sudah tersedia, di sebelah kanan anak tetingkap sifat di bawah Borang Utama Akaun, pilih tab Peristiwa, dan kemudian pergi ke langkah 3.
    • Jika pustaka yang mengandungi fungsi yang anda mahu belum tersedia, pilih Pustaka borang di sebelah kiri anak tetingkap navigasi, dan kemudian pilih Tambah pustaka:
      1. Pada halaman Tambah Pustaka JavaScript, pilih Baharu. Tambah peristiwa borang pada pustaka.
      2. Dalam tab pelayar baharu, lengkapkan sifat untuk mencipta sumber web JScript, dan kemudian pilih Simpan, dan kemudian pilih Terbitkan. Maklumat lanjut: Cipta sumber web JavaScript
      3. Tutup tab pelayar dan kembali ke senarai Tambah Pustaka JavaScript.
      4. Pilih sumber web JavaScript dari pada senarai, pilih Tambah, dan kemudian pilih tab Peristiwa.

      Nota

      Anda mungkin perlu memilih Batal, dan kemudian pilih Tambah Pustaka untuk menyegarkan semula senarai.

  3. Pada tab Peristiwa, pilih Pengendali Peristiwa dan lengkapkan maklumat berikut untuk mengkonfigurasikan peristiwa borang, dan kemudian pilih Selesai:

    • Jenis Peristiwa:

      • Semasa Simpan: Apabila rekod disimpan selepas perubahan medan borang.
      • Semasa Muat: Apabila borang dibuka.

    • Pustaka : Sumber web JavaScript.

    • Fungsi: Nama fungsi dalam sumber web JavaScript yang seharusnya dilaksanakan untuk peristiwa tersebut.

    • Didayakan: Secara lalai, pengendali peristiwa didayakan. Kosongkan kotak semak Didayakan jika anda tidak mahu mendayakan peristiwa ini.

    • Hantar konteks pelaksanaan sebagai parameter pertama : Sesetengah fungsi memerlukan konteks pelaksanaan untuk dihantar ke fungsi. Pilih Serahkan konteks pelaksanaan sebagai parameter yang pertama jika ia diperlukan.

    • Senarai parameter dipisahkan koma yang akan dihantar ke fungsi : Sesetengah fungsi boleh menerima set parameter untuk mengawal tingkah laku fungsi. Jika ini adalah dikehendaki, masukkannya dalam senarai parameter yang dipisahkan oleh Koma yang akan diserahkan ke fungsi.

    • Kebergantungan lajur jadual: Untuk peristiwa Semasa Simpan, pilih lajur yang anda mahu peristiwa dicetuskan selepas rekod disimpan.

      Konfigurasikan peristiwa untuk borang.

  4. Simpan, dan kemudian Terbitkan borang.

Konfigurasikan pengendali peristiwa menggunakan pengalaman klasik

  1. Dalam editor borang klasik, pilih elemen dengan peristiwa yang anda mahu konfigurasikan pengendali.

  2. Pada Tab laman utama, dalam kumpulan Edit, pilih Ubah Sifat atau hanya klik dua kali pada elemen.

  3. Dalam dialog sifat elemen, pilih tab Peristiwa.

  4. Kembangkan kawasan Perpustakaan Borang. Jika perpustakaan yang mengandungi fungsi yang anda hendak tetapkan sebagai pengendali peristiwa belum lagi disenaraikan, tambah perpustakaan.

  5. Untuk menambah pustaka borang pada pengendali peristiwa:

    1. Dalam bahagian Perpustakaan Borang bagi Senarai Peristiwa, pilih Tambah.

    2. Cari sumber web JavaScript dalam senarai sumber-sumber web yang tersedia. Pilih dan kemudian pilih Tambah.

      Jika sumber web JavaScript yang anda perlukan tidak wujud, pilih New untuk membuka borang sumber web baharu dan cipta.

    3. Untuk mencipta sumber web JavaScript, lihat Cipta sumber web JavaScript.

    4. Sumber web yang anda cipta kini dipilih dalam dialog Cari Baris. Pilih Tambah untuk menutup dialog.

  6. Dalam bahagian Pengendali Peristiwa pilih peristiwa yang anda ingin tetapkan pengendali peristiwa.

  7. Pilih Tambah untuk membuka dialog Sifat Pengendali.

  8. Dalam tab Butiran, pilih pustaka yang sesuai dan taipkan nama fungsi yang perlu dilaksanakan untuk peristiwa tersebut.

  9. Secara lalai pengendali peristiwa didayai. Kosongkan kotak semak Didayai jika anda tidak mahu mendayakan peristiwa ini.

    Beberapa fungsi memerlukan satu konteks pelaksanaan untuk dihantar kepada fungsi. Pilih Serahkan konteks pelaksanaan sebagai parameter yang pertama jika ia diperlukan.

    Beberapa fungsi boleh menerima satu set parameter untuk mengawal tingkah laku fungsi. Jika ini diperlukan, masukkannya dalam Senarai parameter dipisahkan koma yang akan dihantar ke fungsi.

  10. Dalam tab Kebergantungan, tambahkan sebarang lajur yang skrip bergantung pada lajur ke dalam kawasan Lajur Tersandar.

  11. Pilih OK untuk menutup dialog Sifat Pengendali.

  12. Apabila pengendali peristiwa dimasukkan anda boleh melaraskan susunan pelaksanaan fungsi tersebut berbanding fungsi lain dengan menggunakan anak panah hijau untuk menggerakkanya ke atas atau ke bawah.

  13. Pilih OK untuk menutup dialog sifat elemen.

  14. Pilih Simpan untuk menyimpan perubahan anda. Pilih Terbit untuk menerbitkan borang.

Nota

Sementara antara muka pengguna (UI) membolehkan anda melaraskan urutan skrip dimuatkan dengan menggunakan anak panah naik dan turun, skrip sebenarnya dimuatkan secara berjujukan.

Cipta sumber web JavaScript

  1. Dalam borang sumber web tetapkan sifat yang berikut:

    Sifat Nilai
    Nama Diperlukan. Taip nama untuk sumber web.
    Paparkan Nama Diperlukan. Taip nama yang akan dipaparkan dalam senarai sumber-sumber web.
    Perihalan Tidak wajib Taip penerangan bagi sumber web.
    Taip Diperlukan. Pilih Skrip (JScript).
    Bahasa Tidak wajib Pilih satu daripada bahasa-bahasa yang tersedia untuk organisasi anda.

  2. Jika anda telah dibekalkan dengan skrip, kami amat mengesyorkan anda untuk menggunakan butang Semak Seimbas untuk mencari fail dan memuatnya naik.

Secara alternatif, anda boleh memilih butang Editor Teks dan tampal atau taip kandungan skrip dalam dialog Edit Kandungan.

Nota

Kerana editor teks ringkas ini tidak menyediakan sebarang ciri untuk menyemak ketepatan skrip, secara amnya anda perlu sentiasa cuba untuk menggunakan aplikasi yang berasingan seperti Visual Studio untuk mengedit skrip dan kemudian memuat naiknya.

  1. Pilih Simpan dan tutup halaman sumber web.

Langkah seterusnya

Lintas Semak: Tulis skrip klien pertama anda
Gunakan borang Utama dan komponennya

Nota

Adakah anda boleh memberitahu kami tentang keutamaan bahasa dokumentasi anda? Jawab tinjauan pendek. (harap maklum bahawa tinjauan ini dalam bahasa Inggeris)

Tinjauan akan mengambil masa lebih kurang tujuh minit. Tiada data peribadi akan dikumpulkan (pernyataan privasi).