Документация для разработчиков
Темная тема

Колонки грида

Набор колонок определяется параметром COLUMNS, либо HEADERS в режиме совместимости с предыдущей реализацией грида. Колонка грида – массив, включающий в себя набор обязательных и дополнительных параметров.

Обязательные параметры

ПараметрТипОписание
idstring / booleanИдентификатор колонки.
namestringЗаголовок колонки, который выводится пользователю.

$column = [
	'id' => 'column_id',
	'name' => 'Заголовок колонки',
];

Дополнительные параметры

ПараметрТипОписание
defaultbooleanОпределяет должна ли отображаться колонка по умолчанию в гриде. По умолчанию колонки не отображаются.
sortstringИдентификатор поля, по которому должна производиться сортировка.
first_orderstringНаправление первой сортировки колонки. Возможные значения: 'asc' или 'desc'.
shownamebooleanПозволяет скрыть заголовок колонки. По умолчанию заголовок выводится.
widthintШирина колонки в пикселях px.
alignstringВыравнивание текста в ячейках колонки. Возможные значения:
  • left
  • center
  • justify
  • right
classstringПользовательский CSS-класс для заголовки колонки.
editablearrayОпределяет параметры инлайн-редактирования. Если не указано, то инлайн-редактирование отключено для ячеек колонки. Массив editable должен содержать обязательный параметр TYPE, который в качестве значения принимает константу из \Bitrix\Main\Grid\Editor\Types.
prevent_defaultbooleanОтменяет выделение строки при клике на ячейку колонки. Может быть полезно, когда в ячейку выводится какой-то интерактивный контент.
stickedbooleanЗакрепляет колонку слева, при горизонтальной прокрутке.
resizeablebooleanПозволяет запретить изменять размер колонки. По умолчанию менять размер колонки разрешено.
colorstringФоновый цвет колонки. В качестве значения можно указать CSS-класс, либо цвет в формате hex, rgb или hsl. Также у грида есть набор стандартных цветов \Bitrix\Main\Grid\Column\Color.



© «Битрикс», 2001-2024, «1С-Битрикс», 2024