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

Строки грида

Строки грида определяются параметром ROWS.


Параметры строки

ПараметрТипОписание
idstring / intИдентификатор строки.
columnsarrayМассив с данными для ячеек колонок, в формате 'COLUMN_ID' => 'Cell data', либо 'COLUMN_ID' => [...] если тип колонки равен LABELS или TAGS из \Bitrix\Main\Grid\Column\Type.

Пример
dataarrayДанные для инлайн-редактирования. Например, если в columns мы можем передать данные для ячейки в том виде, в котором они должны отобразиться, то в data мы можем передать исходные данные которые нужны для редактирования.
'columns' => [
	'HREF' => '<a href="/my/url">My url</a>',
	...,
],
'data' => [
	'HREF' => '/my/url',
	...,    
],

Также, data может использоваться как альтернатива columns, в режиме обратной совместимости с предыдущей реализацией грида. Если columns не указан, то грид попытается вывести данные из data.

editableColumnsarrayОпределяет редактируемость ячеек колонки на уровне строки. Например, если колонка редактируемая, но для конкретной строки нужно запретить редактирование ячейки этой колонки, то в editableColumns можно указать идентификатор колонки со значением false.
'editableColumns' => [
	'MY_COLUMN_ID' => false,
],
actionsarrayОпределяет действия над строкой.
'actions' => [
	[
		'delimiter' => boolean,
		'className' => string,
		'title' => string,
		'text' => string,
		'onclick' => string,
		'href' => string,
		'default' => boolean,
		'items' => array,
	],
	...,
],
customstringПроизвольный контент строки. Выводится в одну ячейку.
countersarrayСчетчики. Позволяет вывести счетчики для любой ячейки строки.
'counters' => [
	'COLUMN_ID' => [
		'type' => \Bitrix\Main\Grid\Counter\Type::LEFT,
		'value' => 2,
		'color' => 'counter-color-css-class',
		'size' => 'counter-size-css-class',
		'class' => 'counter-custom-css-class',
		],
	...,
],
cellActionsarrayПозволяет вывести дополнительные элементы управления для ячейки.
'cellActions' => [
	'col1' => [
		[
			'class' => [
			\Bitrix\Main\Grid\CellActions::PIN,
			\Bitrix\Main\Grid\CellActionState::ACTIVE,
			],
			'events' => [
				'click' => 'onCellActionButtonClick',
				],
			'attributes' => [
				'data-test' => 'test',
			],
		],
		[
			'class' => [
				\Bitrix\Main\Grid\CellActions::MUTE,
				\Bitrix\Main\Grid\CellActionState::ACTIVE,
			],
			'events' => [
				'click' => 'onCellActionButtonClick',
				],
			'attributes' => [
				'data-test' => 'test',
			],
		],
	],
],

Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх