GridV2
Назначение
GridV2 - это компонента, которая используется для отображения информации из базы данных в табличном виде с возможностью сортировки записей в нужном порядке.
Свойства
Компонента имеет набор общих свойств.
| Наименование свойства |
Назначение свойства |
Принимаемые значения |
| Зависит от |
позволяет указать объект (родителя), по идентификатору которого будут отображаться сведения в текущей Таблице; задаётся в случае необходимости связать Таблицу с другой компонентой, например, Выпадающий список или Таблицей |
|
| multiselectable |
Выбор более 1 строки |
Да/Нет. По умолчанию ??? |
| checkboxColumn |
ТУДУ: нельзя менять ширину колонки. Отобразить колонку с флажками для выбора значений. Свойство активно, если задано multiselectable = true |
Да/Нет |
| checkboxHeader |
Добавить выбор/снятие выбора для всех элементов. Свойство активно, если задано checkboxColumn == true |
Да/Нет |
| pinnedBottomRowLabel |
ТУДУ Подпись, которая видна, только если задать checkboxColumn=true ?!!! |
|
| rowClickSelectionType |
Выбор действия по нажатию левой кнопки мыши |
: SUPPRESS_SELECT_CLICK - запрет выбора строк, MULTI_SELECT_CLICK - выбор нескольких строк, SINGLE_SELECT_CLICK - выбор 1 строки. По умолчанию - SINGLE_SELECT_CLICK. |
| showRowNumber |
ТУДУ: нельзя менять ширину колонки. Отобразить колонку с порядковым номером строки |
Да/Нет. По умолчанию - нет |
| floatingFilter |
Добавить компоненты фильтрации в шапке |
Да/Нет. По умолчанию - нет |
| loadOnInit |
Загружать данные при инициализации |
Да/Нет. По умолчанию - да |
| pagination |
Показать элементы для переключения между страницами |
Да/Нет. По умолчанию - нет |
| fetchSize |
|
|
| rowModelType |
Тип загрузки данных |
INFINITE_LOAD - постраничная загрузка данных, CLIENT_SIDE - загрузка всех данных. По умолчанию - CLIENT_SIDE |
| |
|
|
Расширенные свойства
| Наименование свойства |
Назначение свойства |
Принимаемые значения |
| headerHeight |
высота заголовка |
|
| rowHeight |
|
высота строки |
| autoStretchColumns |
ТУДУ: AutoSizeColumn? Растянуть колонки по содержимому |
Да/нет |
| loadingOverlayType |
способ отображения процесса загрузки данных |
TEXT_OVERLAY - визуализация внутри грида, PROGRESS_BAR - блокирующий прогресс бар на странице |
| loadingOverlayMessage |
Сообщение при загрузке данных. Свойство видно если задано loadingOverlayType=TEXT_OVERLAY |
По умолчанию “Загрузка данных, пожалуйста, подождите.” |
| noRowsOverlayMessage |
Сообщение при отсутствии данных. Свойство видно если задано loadingOverlayType=TEXT_OVERLAY |
По умолчанию “Данные отсутствуют” |
| theme |
Визуализация таблицы (темы) |
BOOTSTRAP, BALHAM, BALHAM_DARK, BLUE, DARK, MATERIAL, FRESH |
| allowContextMenuWithControlKey |
Если нет, то при нажатии Ctrl и правой кнопки будет отображение контекстное меню браузера. Иначе всегда контекстное меню таблицы. |
Да/Нет. |
| saveColumnState |
Сохранять ли состояние колонок грида в локальный кэш браузера |
|
| gridConfigurationRowHeight |
Высота строки в диалоге конфигурации колонок грида |
|
| |
|
|
Назначение
Для настройки колонок в GridV2 добавлена компонента GridV2Column, с помощью которой на клиентской части можно настраивать отображение и экспорт данных в колонке.
Свойства
| Наименование свойства |
Назначение свойства |
Принимаемые значения |
| Value Formatter |
Форматирование исходных данных для корректного отображения. При задании серверного и клиентского форматера возможно непредвиденное поведение. Форматирование будет применяться и на строку Итого. |
Принимает один из возможных форматеров (см. раздел Value Formatter ниже). По умолчанию выбран DefaultValueFormatter |
| File Export Formatter |
Форматирование исходных данных для корректного экспорта. |
Принимает один из возможных форматтеров (см. раздел Export Formatter ниже). |
| Renderer |
Позволяет изменить внешний вид GridV2Column (напр. цвет текста). |
Принимает один из возможных GridCellValueRenderer скриптов. |
Value Formatter
| Наименование форматера |
Назначение форматера |
Настраиваемые значения |
| DateFormatter |
Преобразует дату из стандартного (ISO) формата в формат DD.MM.YYYY |
- |
| DateTimeFormatter |
Преобразует дату из стандартного (ISO) формата в формат DD.MM.YYYY hh.mm.ss |
- |
| DefaultValueFormatter |
Предназначен для замены null-значений на настраиваемое |
noDataValue - значение, на которое будет заменяться null, по умолчанию настроено значение пустой строки |
| ReplaceValueFormatter |
Заменяет значения, указанные в Regex, на значения, указанные в New Value |
No Data Value - значение, на которое будет заменяться null, по умолчанию настроено значение пустой строки
Value To Replace - список пар значений Regex, New Value;
Regex - регулярное выражение, которое используется при поиске;
New Value - значение, на которое нужно заменить. |
File Export Formatter
| Наименование форматера |
Назначение форматера |
Настраиваемые значения |
| DateExportFormatter |
Преобразует дату из стандартного (ISO) формата в формат DD.MM.YYYY |
- |
| DateTimeExportFormatter |
Преобразует дату из стандартного (ISO) формата в формат DD.MM.YYYY hh.mm.ss |
- |
Renderer
| Наименование скрипта |
Назначение форматера |
Настраиваемые значения |
| ChangeColorOnColumnValueColumnCellRenderer |
Позволяет изменять цвет текущего GridV2Column на основе значения из любого GridV2Column на странице |
Grid Column - позволяет указать GridV2Column, который будет использоваться для сравнения значений. Color For Value - позволяет выбрать цвет для каждого значения, которому равен выбранный GridV2Column. |