Колекція елементів керування (довідник із інтерфейсу 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 клієнта)