Компонент Edit Grid

🌐 Цей документ доступний українською та англійською мовами. Використовуйте перемикач у правому верхньому куті, щоб змінити версію.

1. Опис компонента

Компонент Edit Grid є потужним інструментом для роботи з таблицями у формах і дозволяє динамічно додавати, редагувати та видаляти рядки з таблиці. Це поле відображається у формі як таблиця, яка містить дані, які користувачі можуть редагувати. Компонент дозволяє вам налаштувати відображення, валідацію та інші опції для кожного рядка.

Розширення стандартного компонента Edit Grid включає додавання додаткових опцій, які спрощують моделювання. Це дозволяє розробникам та моделювальникам регламенту використовувати цей компонент більш гнучко та підлаштувати його під специфічні потреби різноманітних бізнес-сценаріїв.

Використовуйте Edit Grid з переліку Оновлених компонентів.

2. Основні функції

Компонент Edit Grid підтримує велику кількість опцій для застосування при взаємодії із формою процесу, які розподілені за вкладками.

  • Display

  • Data

  • Validation

  • API

  • Logic

  • Label: назва компонента, яка відображається поряд з ним.

  • Label Position: визначає положення мітки відносно компонента (верх, праворуч, зліва, або внизу).

  • Description: опис компонента, який може допомогти користувачам зрозуміти його призначення.

  • Tooltip: текст, який відображається при наведенні курсора на компонент.

  • Quick Search: дозволяє користувачам швидко знаходити записи в таблиці, використовуючи простий пошуковий фільтр.

  • Hidden: поля, які приховані від користувача, але все ще є частинами форми й будуть передані при відправленні форми.

  • Multiple-record selection: дозволяє користувачам вибирати кілька записів в таблиці одночасно.

  • Read Only: показує дані через окремий елемент управління в контекстному меню (три вертикальних крапки), який дозволяє переглядати дані без можливості редагування.

  • Redraw On: перемальовує компонент, якщо інший компонент змінюється.

  • Clear value when hidden: коли значення приховане, очищує значення.

  • Validate On: визначає, коли цей компонент повинен активувати валідацію на клієнті (опції Зміна або Розмиття).

  • Required: поле обов’язкове для заповнення перед відправленням форми.

  • Minimum length: мінімальна кількість символів, які користувач повинен ввести.

  • Maximum length: максимальна кількість символів, які користувач може ввести.

  • Custom error message: спеціальне повідомлення про помилку, яке відображається, коли дані не проходять валідацію.

  • Custom validation: власна валідація, яка дозволяє вам створити специфічні для ваших потреб перевірки на валідність.

  • Property name: ім’я цього поля для API-ендпоінту, яке відповідає назві таблиці у базі даних реєстру. Наприклад, licences.

  • Record Actions: дії, які можна виконати із записами в таблиці (максимальна кількість дій — 5). Наприклад, можна змінити дату терміну дії ліцензії (Action: _action_update) або анулювати ліцензію (Action: _action_cancel) тощо.

3. Формат даних

Компонент приймає масив об’єктів. Кожен об’єкт у масиві може містити різні поля та їх значення. У прикладі нижче наведено один об’єкт з полем "textfield" та значенням 'test'.

Submission
Array<Object>
// Приклад: [ { textfield: 'test' } ]