Столбцы
Колонки решают, как таблица выглядит в менеджере: какие значения показывает грид, в каком порядке и в каком виде.
Колонка обычно указывает на поле: полю принадлежат данные, колонке — их подача.
Что содержит строка колонки
| Настройка | Что делает |
|---|---|
| Поле | Какое поле показывает эта колонка |
| Заголовок | Замена заголовка. Пусто — берётся подпись поля |
| Ширина | Ширина колонки в гриде |
| Значение по умолчанию | Показывается, когда значение пустое |
| Сортируемая | Клик по заголовку сортирует по этой колонке |
| Порядок | Место среди колонок |
| Опубликована | Неопубликованная колонка не рисуется |
Строка поиска над гридом настраивается не здесь: она ищет по полям, отмеченным флагом Искомое у самого поля, — есть у них колонка или нет.
Три вида колонки
Колонка не обязана показывать одно поле. Вид выбирается на самой колонке:
field — одно значение
Обычный случай: одно поле, одна ячейка.
group — несколько значений в одной ячейке
Несколько полей показываются вместе в одной колонке. Город и страна, ширина и высота — значения, которые читаются как одно целое и зря занимают по колонке каждое.
По умолчанию значения выводятся голыми. Переключите Заголовки полей на «Показывать» — и каждое получит подпись своего поля; это нужно, когда значения сами за себя не говорят:
Москва, Россия ← без подписей
Город: Москва Страна: Россия ← с подписями«Скрывать» стоит по умолчанию намеренно: колонка, которая ничего не просила, сохраняет тот простой вид, который был у неё до появления настройки.
condition — первое непустое
Несколько полей пробуются по очереди, побеждает первое непустое, а если пустые все — берётся значение по умолчанию колонки.
Это та самая лесенка запасных вариантов, которую иначе пишут в рендерере: отображаемое имя, потом название компании, потом логин. Одна колонка и ни одной пустой ячейки.
У сортировки есть предел
Колонку по полю конструктора отсортировать нельзя. Значение лежит внутри JSON-колонки, и упорядочить по нему запрос не может.
Фильтрация и поиск по таким полям при этом работают — не работает только ORDER BY.
У полей конструктора флаг сортировки не включайте
Если включить, ничего не сломается и ошибки не будет: такой колонки в таблице нет, и запрос откатывается к сортировке по id. Заголовок остаётся кликабельным, а порядок не меняется — это замечают дольше, чем падение.
Колонки по настоящим колонкам таблицы сортируются как обычно.
Ширина задаётся в пикселях
От 0 до 600. Любое значение, кроме 0, — фиксированная ширина в пикселях; 0 означает «подобрать автоматически», и тогда грид делит между такими колонками то, что осталось после фиксированных. Задавайте ширину двум-трём колонкам, чей размер действительно важен, а остальным оставляйте ноль.