Кнопки в заголовке Битрикс24: работа с Toolbar
Чтобы добавить в заголовок страницы свою кнопку, не обязательно вставлять HTML или искать элементы через JavaScript. На страницах со штатным Toolbar можно использовать PHP API: добавить ссылку, открыть форму в слайдере или вывести меню действий.
Примеры предназначены для коробочного Битрикс24. Код должен выполняться до вывода Toolbar. Сам вызов addButton() не создаёт панель на странице.
Подключение модуля
Подключим модуль ui и расширение кнопок:
<?php
use Bitrix\Main\Loader;
use Bitrix\Main\UI\Extension;
use Bitrix\UI\Buttons\Button;
use Bitrix\UI\Buttons\Color;
use Bitrix\UI\Buttons\Icon;
use Bitrix\UI\Buttons\JsCode;
use Bitrix\UI\Toolbar\Facade\Toolbar;
if (!Loader::includeModule('ui')) {
throw new \RuntimeException('Не удалось подключить модуль ui');
}
Extension::load('ui.buttons');
Следующие примеры используют эти импорты.
Кнопка со ссылкой
Добавим кнопку перехода к отчётам:
Toolbar::addButton(
new Button([
'text' => 'Отчёты',
'color' => Color::SECONDARY,
'icon' => Icon::LIST,
'link' => '/company/reports/',
])
);
text задаёт надпись, color - оформление, icon - иконку, а link -адрес перехода. Замените URL на существующую страницу проекта.
Иконка также пригодится при небольшой ширине экрана: Toolbar может скрыть текст кнопки, оставив только её.
Открытие формы в слайдере
Для открытия боковой панели подключим sidepanel и зададим обработчик нажатия:
Extension::load('sidepanel');
$formUrl = '/company/tools/request-form.php';
Toolbar::addButton(
new Button([
'text' => 'Создать заявку',
'color' => Color::SUCCESS,
'icon' => Icon::ADD,
'click' => new JsCode(
"BX.SidePanel.Instance.open('"
. \CUtil::JSEscape($formUrl)
. "', {
width: 720,
cacheable: false,
allowChangeHistory: false
});"
),
])
);
width задаёт ширину слайдера, cacheable: false отключает повторное использование закрытой панели, а allowChangeHistory: false запрещает менять адрес в браузере.
CUtil::JSEscape() экранирует URL для вставки в JavaScript-строку.
Страницу формы нужно создать отдельно и подготовить к отображению внутри слайдера. Кнопка только открывает её — сохранение данных она не реализует.
Кнопка с выпадающим меню
Несколько вспомогательных действий можно объединить в одну кнопку:
Toolbar::addButton(
new Button([
'text' => 'Инструменты',
'color' => Color::LIGHT_BORDER,
'icon' => Icon::SETTINGS,
'menu' => [
'items' => [
[
'text' => 'Отчёты',
'href' => '/company/reports/',
],
[
'text' => 'Настройки',
'href' => '/company/settings/',
],
[
'delimiter' => true,
],
[
'text' => 'Инструкция',
'href' => '/company/help/',
],
],
],
])
);
В items перечисляются пункты меню: text задаёт название, href — ссылку, а delimiter добавляет разделитель.
Размещайте код в собственном компоненте или подходящей точке расширения до вывода панели, не изменяя файлы ядра. Проверку прав и сохранение данных выполняйте в серверном обработчике — наличие или отсутствие кнопки не ограничивает доступ к операции.
Документация: типовое использование Toolbar.