Ambil perhatian
Akses ke halaman ini memerlukan kebenaran. Anda boleh cuba log masuk atau menukar direktori.
Akses ke halaman ini memerlukan kebenaran. Anda boleh cuba menukar direktori.
Acara memulakan semua kod bahagian pelanggan. Dalam aplikasi dipacu model, anda mengaitkan fungsi tertentu dalam pustaka JavaScript (sumber web Skrip) untuk dilaksanakan apabila 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 peristiwa kepada hanya beberapa peristiwa menggunakan UI. Untuk peristiwa yang tidak tersedia untuk dikaitkan melalui UI, API Pelanggan menyediakan kaedah yang boleh digunakan untuk melampirkan pengendali peristiwa pada peristiwa tersebut.
Tambah atau alih keluar fungsi pengendali acara pada acara menggunakan UI
Gunakan bahagian Pengendali Peristiwa pada kotak dialog Sifat Borang untuk mengaitkan skrip anda dengan peristiwa untuk borang dan lajur.
Borang suntingan pukal
Secara lalai, pengendali peristiwa tidak dipanggil apabila borang berada dalam mod edit pukal.
Untuk mendayakan pengendali peristiwa dalam mod edit pukal, ubah suai XML Borang dengan mencari elemen yang berkaitan event dan mencipta/menetapkan BehaviorInBulkEditForm atribut kepada Enabled. Pada masa ini, ini hanya disokong untuk acara OnLoad.
Untuk maklumat lanjut tentang penyesuaian XML Borang, lihat Masa untuk mengedit fail penyesuaian, Sesuaikan borang dan skema XML Borang.
Untuk menentukan masa pengendali peristiwa dipanggil pada borang dalam mod edit pukal, gunakan getFormType kaedah.
Tambah atau alih keluar fungsi pengendali acara kepada acara menggunakan kod
Menggunakan kaedah berikut untuk menambah dan mengalih keluar pengendali peristiwa untuk peristiwa yang tidak boleh dikaitkan melalui UI:
| 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 ditetapkan menggunakan kod. Maklumat lanjut: Konteks pelaksanaan API Pelanggan
Saluran paip acara borang
Anda boleh mentakrifkan sehingga 50 pengendali peristiwa untuk setiap acara. Setiap pengendali peristiwa dilaksanakan mengikut tertib yang dipaparkan dalam bahagian Pengendali Peristiwa dalam tab Peristiwa pada kotak dialog Sifat Borang .
Gunakan kaedah setSharedVariable dan getSharedVariable untuk menghantar pembolehubah biasa antara pengendali peristiwa (fungsi). Gunakan kaedah getDepth konteks pelaksanaan untuk mengetahui jujukan yang pengendali peristiwa sedang dilaksanakan berbanding pengendali peristiwa lain.
Artikel berkaitan
Fahami model objek API Pelanggan
Konteks pelaksanaan API pelanggan
Peristiwa (rujukan API Klien)