Controls 컬렉션(클라이언트 API 참조)

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입니다.

컨트롤 getName 메서드를 사용하는 경우 첫 번째 컨트롤의 이름이 열의 이름과 일치합니다. 해당 열에 대한 컨트롤의 두 번째 인스턴스는 .입니다 <columnName>1. <columnName>+N 패턴은 특정 열에 대한 폼에 추가된 각 추가 컨트롤에 대해 계속됩니다.

양식에 머리글에 비즈니스 프로세스 흐름 컨트롤이 표시되면 비즈니스 프로세스 흐름에 표시되는 각 열에 대한 컨트롤이 추가됩니다. 이러한 컨트롤에는 다음과 header_process_<column name>같은 고유한 이름이 있습니다.

열(클라이언트 API 참조)