Кнопки в заголовке Битрикс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.

27