使用 controls 集合來存取與欄位相關的控制項。
當你對與欄位綁定的控制項執行操作時,請考慮該控制項可能會在頁面上出現不只一次。 一般來說,你應該對該欄位的每個控制項執行相同的操作。 你可以循環於欄位控制集合中,對每個控制項執行相應操作。
例如,要為綁定在該 name 欄位的每個控制項新增通知,請使用以下程式碼:
const notification = {
messages: ['Sample Notification on Name Controls'],
notificationLevel: 'RECOMMENDATION',
uniqueId: 'my_unique_id'
};
formContext.getAttribute("name").controls.forEach(control =>
control.addNotification(notification)
);
由於每個欄位可能在頁面上出現多次,控制項集合提供存取代表該欄位的所有控制項。 若該欄在頁面上僅有一個控制項表示,該集合長度為 1。
當你使用 control getName 方法時,第一個控制項的名稱會與欄位名稱相符。 該欄的第二個控制實例為 <columnName>1。 此模式 <columnName>+N 會隨著表格中新增特定欄位的控制項而持續進行。
當表單在標頭顯示業務流程控制時,會為業務流程中出現的每一欄新增控制。 這些控制項有獨特名稱,如下: header_process_<column name>。