Гриды в Битрикс24: теперь не нужно искать  сторонние решения18.10.2024 14:31

Вжух, в нижней панели грида у нас появился селектор с действиями:

Теперь поговорим о логике работы селектора в момент, когда мы выбираем элемент списка. При его выборе срабатывает событие onchange. Оно выполняет действия, указанные в методе getOnchange для класса нашего действия:

 Actions::RESET_CONTROLS,
        	],
        	// создаем кнопку
        	[
            	'ACTION' => Actions::CREATE,
            	'DATA' => [
                	// добавляем кнопку, которая выполняет JS код, который отправляет выбранные строки грида
                	(new Snippet)->getApplyButton([
                    	'ONCHANGE' => [
                        	[
                            	'ACTION' => Actions::CALLBACK,
                            	'DATA' => [
                                	[
                                    	'JS' => 'CurrentGrid.sendSelected()',
                                	]
                            	],
                        	],
                    	],
                	]),
            	],
        	],
    	]);
	}
}

Далее добавляем обработчик запроса в действии:

getValue() ?? [];
		}
		else
		{
			$filter = [
				'@ID' => $this->getRequestRows($request),
			];
		}

		$rows = UserTable::getList([
			'select' => [
				'ID',
			],
			'filter' => $filter,
		]);
		foreach ($rows as $row)
		{
			$user = new CUser();
			$user->Update($row['ID'], [
				'ACTIVE' => 'N',
			]);
			if ($user->LAST_ERROR)
			{
				$result->addError(
					new Error($user->LAST_ERROR)
				);
			}
		}

		return $result;
	}
}

При передаче аргумента $isSelectedAllRows важно обязательно использовать фильтр, если он передан. Если такой галочки не стоит, то можно воспользоваться методом базового класса Bitrix\Main\Grid\Panel\Action\Group\GroupChildAction: getRequestRows. Он вытащит из запроса выбранные строки.

Работа с результатом аналогична всем другим обработчикам: если вы передали ошибки, они будут отражены в интерфейсе.

Шаг 9. Добавляем фильтр

Грид можно использовать с фильтрами и без. В данном случае это отдельная сущность. Когда мы разобрались с отображением самого грида, можем приступать к отображению фильтра. Механика практически та же самая.  

Пока добавим класс для фильтра с провайдером полей на базе таблета:

 $gridId,
				]),
				$entity,
				selectFields: [
					'ID',
					'ACTIVE',
					'LOGIN',
					'EMAIL',
					'NAME',
					'SECOND_NAME',
					'LAST_NAME',
					'DATE_REGISTER',
					'LAST_LOGIN',
				],
				defaultFields: [
					'ID',
					'ACTIVE',
					'LOGIN',
					'EMAIL',
					'NAME',
					'LAST_NAME',
					'DATE_REGISTER',
				],
			)
		);
	}
}

Обратите внимание, что TabletDataProvider идентичен по аргументам с TabletColumnProvider, и можно сразу указать поля, которые участвуют в фильтре. Первым параметром обязательно передаются настройки фильтра. Создадим фильтр в классе грида:

getId(),
			$this->getEntity(),
		);
	}
}

Фильтр — это отдельный виджет, и он связывается с гридом исключительно по ID. Мы передадим ID грида в конструктор и добавим отображение фильтра в шаблоне компонента. Код шаблона компонента будет выглядеть так:

IncludeComponent(
			'bitrix:main.ui.filter',
			'',
			$componentParams,
		);
	}
}

$APPLICATION->IncludeComponent(
	'bitrix:main.ui.grid',
	'',
	\Bitrix\Main\Grid\Component\ComponentParams::get(
		$arResult['~GRID']
	)
);

Смотрим на страницу и видим, что вверху над гридом появился фильтр:

Итак, у нас получился простой работающий грид, и его можно встроить в интерфейс и использовать. В следующий раз я подробно расскажу о том, как сделать полную кастомизацию грида в Битрикс24. 

Работали с гридами ранее? Как сейчас их реализуете?  

Если вы регулярно работаете с Битрикс24, как разработчик, для нашей команды будет ценной обратная связь. Поделитесь, подходит ли формат подобных статей, что хочется в него добавить, или каких обновлений в продукте вам не хватает.

Описанный функционал выйдет совсем скоро в свежем апдейте модуля main, не забудьте обновиться ;-)

© Habrahabr.ru