Chia sẻ qua


Các sự kiện trong biểu mẫu và lưới trong ứng dụng dựa trên mô hình

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.

Phần Trình xử lý Sự kiện trong Thuộc tính Biểu mẫu.

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 addOnLoadremoveOnLoad
Biểu mẫu đã Tải formContext.ui addLoadedremoveLoaded
Tải dữ liệu biểu mẫu phương pháp formContext.data addOnLoadremoveOnLoad
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.

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)