Bộ sưu tập điều khiển (Tài liệu tham khảo về API máy khách)

Sử dụng bộ sưu controls tập để truy nhập các điều khiển được liên kết với các cột.

Khi bạn thực hiện hành động trên các điều khiển gắn với một cột, hãy cân nhắc rằng điều khiển có thể xuất hiện trên trang nhiều lần. Thông thường, bạn nên thực hiện các hành động tương tự cho từng điều khiển cho cột. Bạn có thể di chuyển vòng lặp qua bộ sưu tập điều khiển cột và thực hiện các hành động trên từng điều khiển.

Ví dụ: để thêm thông báo cho mỗi điều khiển được liên kết với cột name , hãy sử dụng mã sau đây:

const notification = {
    messages: ['Sample Notification on Name Controls'],
    notificationLevel: 'RECOMMENDATION',
    uniqueId: 'my_unique_id'
 };
 
formContext.getAttribute("name").controls.forEach(control =>
    control.addNotification(notification)
 );

Vì mỗi cột có thể xuất hiện nhiều lần trên trang, bộ sưu tập điều khiển cung cấp quyền truy nhập vào tất cả các điều khiển đại diện cho cột đó. Nếu cột chỉ được thể hiện bằng một điều khiển trên trang, độ dài của bộ sưu tập này là 1.

Khi bạn sử dụng phương pháp getName điều khiển, tên của điều khiển đầu tiên khớp với tên của cột. Phiên bản thứ hai của điều khiển cho cột đó là <columnName>1. Mẫu sẽ tiếp <columnName>+N tục cho mỗi điều khiển bổ sung được thêm vào biểu mẫu cho một cột cụ thể.

Khi một biểu mẫu hiển thị điều khiển dòng quy trình kinh doanh ở đầu trang, biểu mẫu sẽ thêm các điều khiển cho từng cột xuất hiện trong dòng quy trình kinh doanh. Các điều khiển này có tên duy nhất như sau: header_process_<column name>.

Bài viết liên quan

Cột (Tài liệu tham khảo về API máy khách)