Chia sẻ qua


formContext.getControl (Tài liệu tham khảo về API máy khách)

Lấy điều khiển trên biểu mẫu.

Lưu ý

getControl chỉ hoạt động trên các điều khiển trong nội dung và đầu trang của biểu mẫu. Nó không được hỗ trợ cho các điều khiển ở nơi khác trên trang, ngay cả khi chúng tham chiếu đến cùng một cột.

Cú pháp

formContext.getControl(arg);

Phương pháp formContext.getControl(arg) là phương pháp lối tắt để truy nhập formContext.ui.controls.get.

Tham số

arg: Tùy chọn. Bạn có thể truy nhập điều khiển trên biểu mẫu bằng cách truyền đối số dưới dạng tên hoặc giá trị chỉ mục của điều khiển trên biểu mẫu. Ví dụ: formContext.getControl("firstname") hoặc .formContext.getControl(0) Nếu tên arg viết sai chính tả và không có trong biểu mẫu, nó trả về giá trị null.

Khi giá trị arg không được cung cấp, nó trả về một mảng tất cả các điều khiển trên biểu mẫu.

Trả về giá trị

Loại: Tuyển tập đối tượng, Đối tượng hoặc null.

Mô tả: Tuyển tập đối tượng nếu bạn sử dụng phương pháp mà không có bất kỳ tham số nào. Đối tượng hoặc null nếu bạn sử dụng phương pháp với tham số. Nếu bạn sử dụng tên làm tham số và có nhiều điều khiển cho cùng một cột thì chỉ có điều khiển đầu tiên được trả về.

Tiền boa

Nếu bạn muốn sửa đổi tất cả các điều khiển được liên kết với một cột trên biểu mẫu, hãy sử dụng bộ sưu tập điều khiển bên trong kiểu cột. Ví dụ: để thêm thông báo vào từng điều khiển được liên kết với cột name , bạn có thể thực hiện các thao tác sau:

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

formContext