Коллекция элементов управления (справочник по 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)