Lưu ý
Cần có ủy quyền mới truy nhập được vào trang này. Bạn có thể thử đăng nhập hoặc thay đổi thư mục.
Cần có ủy quyền mới truy nhập được vào trang này. Bạn có thể thử thay đổi thư mục.
Sự kiện khởi tạo tất cả mã phía máy khách. Trong các ứng dụng dựa trên mô hình, bạn liên kết một hàm cụ thể trong thư viện JavaScript (Tài nguyên web tập lệnh) sẽ được thực thi khi sự kiện xảy ra. Hàm này được gọi là trình xử lý sự kiện. Mỗi bộ xử lý sự kiện chỉ định một hàm duy nhất trong một thư viện JavaScript và bất kỳ tham số nào có thể truyền cho hàm.
Bạn có thể liên kết trình xử lý sự kiện chỉ với một số sự kiện bằng cách sử dụng giao diện người dùng. Đối với các sự kiện không có sẵn để liên kết thông qua giao diện người dùng, API Máy khách cung cấp các phương pháp có thể được sử dụng để đính kèm trình xử lý sự kiện vào các sự kiện đó.
Thêm hoặc loại bỏ hàm của trình xử lý sự kiện vào sự kiện bằng giao diện người dùng
Sử dụng phần Bộ xử lý Sự kiện của hộp thoại Thuộc tính Biểu mẫu để liên kết tập lệnh của bạn với một sự kiện cho biểu mẫu và cột.
Sửa hàng loạt biểu mẫu
Theo mặc định, trình xử lý sự kiện không được gọi khi một biểu mẫu ở chế độ sửa hàng loạt.
Để bật trình xử lý sự kiện trong chế độ sửa hàng loạt, hãy sửa đổi XML event Biểu mẫu bằng cách tìm phần tử liên quan và tạo/đặt thuộc BehaviorInBulkEditForm tính thành Enabled. Hiện tại, điều này chỉ được hỗ trợ cho các sự kiện OnLoad.
Để biết thêm thông tin về tùy chỉnh XML biểu mẫu, hãy xem mục Khi nào sửa tệp tùy chỉnh, Tùy chỉnh biểu mẫu và sơ đồ XML Biểu mẫu.
Để xác định khi nào một trình xử lý sự kiện được gọi trên một biểu mẫu trong phương pháp sử dụng chế độ sửa hàng getFormType loạt.
Thêm hoặc loại bỏ hàm của trình xử lý sự kiện vào sự kiện bằng mã
Sử dụng các phương pháp sau đây để thêm và loại bỏ trình xử lý sự kiện cho các sự kiện không thể liên kết thông qua giao diện người dùng:
| Sự kiện | Trình xử lý sự kiện |
|---|---|
| Thuộc tính OnChange | phương pháp addOnChangevà loại bỏOnChange |
| Tải Biểu mẫu | phương pháp formContext.ui addOnLoad và removeOnLoad |
| Biểu mẫu đã Tải | formContext.ui addLoaded và removeLoaded |
| Tải dữ liệu biểu mẫu | phương pháp formContext.data addOnLoad và removeOnLoad |
| Lưu Biểu mẫu | phương pháp addOnSavevà removeOnSave |
| Tìm kiếm Trước điều khiển tra cứu | thêmPreSearch vàloại bỏ các phương phápPreSearch |
| điều khiển kbsearch OnResultOpened | phương pháp addOnResultOpenedvà removeOnResultOpened |
| điều khiển tìm kiếm kb OnSelection | phương pháp addOnSelectionvà removeOnSelection |
| kbsearch điều khiển PostSearch | addOnPostSearch và loại bỏ các phương phápOnPostSearch |
Quan trọng
Ngữ cảnh thực thi được tự động chuyển thành tham số đầu tiên cho các hàm được đặt bằng cách sử dụng mã. Thông tin thêm: Ngữ cảnh thực thi API máy khách
Quy trình sự kiện biểu mẫu
Bạn có thể xác định tối đa 50 bộ xử lý sự kiện cho mỗi sự kiện. Mỗi bộ xử lý sự kiện được thực hiện theo thứ tự hiển thị trong phần Bộ xử lý Sự kiện trong tab Sự kiện của hộp thoại Thuộc tính Biểu mẫu.
Sử dụng setSharedVariable vàgetSharedVariable để truyền biến số chung giữa các bộ xử lý sự kiện (hàm). Sử dụng phương pháp getDepth ngữ cảnh thực hiện để biết trình tự mà trình xử lý sự kiện đang được thực hiện trong tương đối với các bộ xử lý sự kiện khác.
Bài viết liên quan
Hiểu mô hình đối tượng API máy khách
Ngữ cảnh thực thi API máy khách
Sự kiện (Tài liệu tham khảo về API máy khách)