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

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

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

Параметр Тип Описание

id string / boolean Идентификатор колонки.

name string Заголовок колонки, который выводится пользователю.

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

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

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

Параметр Тип Описание

default boolean Определяет должна ли отображаться колонка по умолчанию в гриде. По умолчанию колонки не отображаются.

sort string Идентификатор поля, по которому должна производиться сортировка.

first_order string Направление первой сортировки колонки. Возможные значения: 'asc' или 'desc'.

showname boolean Позволяет скрыть заголовок колонки. По умолчанию заголовок выводится.

width int Ширина колонки в пикселях px.

align string Выравнивание текста в ячейках колонки. Возможные значения:

left

center

justify

right

class string Пользовательский CSS-класс для заголовки колонки.

editable array Определяет параметры инлайн-редактирования. Если не указано, то инлайн-редактирование отключено для ячеек колонки. Массив editable должен содержать обязательный параметр TYPE, который в качестве значения принимает константу из \Bitrix\Main\Grid\Editor\Types.

prevent_default boolean Отменяет выделение строки при клике на ячейку колонки. Может быть полезно, когда в ячейку выводится какой-то интерактивный контент.

sticked boolean Закрепляет колонку слева, при горизонтальной прокрутке.

resizeable boolean Позволяет запретить изменять размер колонки. По умолчанию менять размер колонки разрешено.

color string Фоновый цвет колонки. В качестве значения можно указать CSS-класс, либо цвет в формате hex, rgb или hsl. Также у грида есть набор стандартных цветов \Bitrix\Main\Grid\Column\Color.

Параметр	Тип	Описание
default	boolean	Определяет должна ли отображаться колонка по умолчанию в гриде. По умолчанию колонки не отображаются.
sort	string	Идентификатор поля, по которому должна производиться сортировка.
first_order	string	Направление первой сортировки колонки. Возможные значения: 'asc' или 'desc'.
showname	boolean	Позволяет скрыть заголовок колонки. По умолчанию заголовок выводится.
width	int	Ширина колонки в пикселях px.
align	string	Выравнивание текста в ячейках колонки. Возможные значения: left center justify right
class	string	Пользовательский CSS-класс для заголовки колонки.
editable	array	Определяет параметры инлайн-редактирования. Если не указано, то инлайн-редактирование отключено для ячеек колонки. Массив editable должен содержать обязательный параметр TYPE, который в качестве значения принимает константу из \Bitrix\Main\Grid\Editor\Types.
prevent_default	boolean	Отменяет выделение строки при клике на ячейку колонки. Может быть полезно, когда в ячейку выводится какой-то интерактивный контент.
sticked	boolean	Закрепляет колонку слева, при горизонтальной прокрутке.
resizeable	boolean	Позволяет запретить изменять размер колонки. По умолчанию менять размер колонки разрешено.
color	string	Фоновый цвет колонки. В качестве значения можно указать CSS-класс, либо цвет в формате hex, rgb или hsl. Также у грида есть набор стандартных цветов \Bitrix\Main\Grid\Column\Color.

Наверх