Blade-компоненты помогают вынести повторяющиеся блоки (карточки, формы, уведомления) в отдельные шаблоны с параметрами и слотами, чтобы менять их в одном месте. Модуль BB Components позволяет внедрять их постепенно на «1С-Битрикс» без смены URL и отказа от штатных компонентов.

Полностью менять CMS или переписывать работающий сайт ради более удобных шаблонов обычно не нужно. Но как сделать повторяющиеся блоки самостоятельными, передавать им параметры и при этом сохранить привычные страницы и компоненты Битрикса? Один из вариантов — использовать Blade-компоненты и внедрять их постепенно. В этой статье разберём, какую задачу они решают, где заканчиваются их преимущества и как в эту схему вписывается модуль BB Components.
Почему повторяющийся блок становится сложным в поддержке?
Проблема заметна не обязательно в первой версии сайта. Она проявляется, когда похожий блок копируют в разные шаблоны, а затем эти копии начинают меняться независимо друг от друга.
- Разметка расходится. В одном месте обновили класс или структуру HTML, в другом забыли. Постепенно похожие блоки перестают быть одинаковыми.
- Небольшая правка затрагивает несколько файлов. Разработчику приходится искать все варианты блока и проверять, не отличается ли поведение на конкретной странице.
- В PHP-шаблоне смешиваются разные задачи. В одном файле могут соседствовать HTML, вывод данных, условия и вызовы компонентов. Такой код можно поддерживать, но при росте числа вариантов его сложнее разделять на независимые части.
- Большой перенос откладывается. Если новый подход требует сразу переписать раздел или менять URL, задача конкурирует с текущей поддержкой сайта.
Это не означает, что PHP-шаблоны сами по себе плохи. Сложность возникает, когда странице не хватает удобного способа описать повторно используемый блок, его входные параметры и место для вложенного содержимого.
Зачем здесь Blade-компоненты?
Blade-компонент — это шаблон блока с понятным контрактом как у HTML элементов или JSX компонентов: какие данные он принимает, что показывает по умолчанию и куда помещает переданное содержимое.
Вместо копирования разметки по страницам разработчик выносит повторяемую часть в отдельный файл компонента и вызывает её там, где она нужна.
Это даёт несколько практических преимуществ:
- Единое место для общей разметки. Если блок действительно повторяется, его оформление можно менять в одном файле, а не синхронизировать копии вручную.
- Явные параметры и значения по умолчанию. По вызову видно, какие данные меняют вариант блока; необязательные параметры не нужно каждый раз задавать одинаково.
- Слоты для содержимого. Компонент задаёт оболочку, а страница передаёт внутрь свой текст или вложенную разметку.
- Постепенная миграция. Можно начать с одного блока и одной страницы, не перенося весь сайт и не меняя публичные URL.
- Совместная работа с Битриксом. Blade-шаблон может вызывать штатный компонент платформы, поэтому переход не требует заменять всё, что уже работает.
Компонентный подход полезен не сам по себе, а когда у блока есть реальное повторное использование или несколько вариантов. Уникальную разметку, которая встречается один раз и не имеет отдельного поведения, не обязательно превращать в компонент.
Сравнение на примере Hero-блока: чистый Битрикс и Blade компонент
Сравним одну и ту же секцию: заголовок, описание, изображение и кнопку. Пример показывает форму решения, а не готовый к установке компонент: конкретные параметры и обработку изображений нужно сверить с устройством проекта.
На чистом Битрикс
Страница передаёт параметры через IncludeComponent. Компонент подготавливает $arResult, а его template.php выводит HTML.
$APPLICATION->IncludeComponent(
"local:hero",
".default",
[
"TITLE" => "Сайт, который удобно развивать",
"DESCRIPTION" => "Соберите страницу из повторно используемых блоков.",
"IMAGE" => "/upload/hero.jpg",
"IMAGE_ALT" => "Пример страницы сайта",
"BUTTON_TEXT" => "Посмотреть каталог",
"BUTTON_URL" => "/catalog/",
]
);
В template.php параметры выводятся из $arResult; динамические значения нужно экранировать:
<section class="hero">
<div class="hero__content">
<h1><?= htmlspecialcharsbx($arResult["TITLE"]) ?></h1>
<p><?= htmlspecialcharsbx($arResult["DESCRIPTION"]) ?></p>
<a class="button" href="<?= htmlspecialcharsbx($arResult["BUTTON_URL"]) ?>">
<?= htmlspecialcharsbx($arResult["BUTTON_TEXT"]) ?>
</a>
</div>
<img
src="<?= htmlspecialcharsbx($arResult["IMAGE"]) ?>"
alt="<?= htmlspecialcharsbx($arResult["IMAGE_ALT"]) ?>"
>
</section>
В реальном компоненте потребуются также component.php, описание параметров и шаблон. Такой подход остаётся штатным и подходит, когда нужна логика и жизненный цикл компонента Битрикса.
На Blade через BB Components
В BB Components похожий блок можно описать анонимным компонентом в local/x-components/hero.blade.php:
@props(['title', 'description', 'image', 'imageAlt' => '', 'buttonText', 'buttonUrl'])
<section class="hero">
<div class="hero__content">
<h1>{{ $title }}</h1>
<p>{{ $description }}</p>
<x-button :href="$buttonUrl" variant="primary">
{{ $buttonText }}
</x-button>
</div>
<img src="{{ $image }}" alt="{{ $imageAlt }}">
</section>
Страница вызывает его с нужными данными:
<x-hero
title="Сайт, который удобно развивать"
description="Соберите страницу из повторно используемых блоков."
image="/upload/hero.jpg"
image-alt="Пример страницы сайта"
button-text="Посмотреть каталог"
button-url="/catalog/"
/>
Здесь x-button — отдельный Blade-компонент, например local/x-components/button.blade.php. Если кнопка в проекте не переиспользуется, её можно оставить обычной HTML-разметкой внутри Hero.
Что показывает сравнение?
Обе реализации могут вывести одинаковую страницу, но ключевое различие — в композиции. Штатный компонент Битрикса вызывается через PHP ($APPLICATION->IncludeComponent()); такой вызов можно вложить в другой PHP-шаблон, но его нельзя записать прямо в разметке как <x-parent><x-child /></x-parent>. Blade-компоненты можно собирать именно так — как HTML-элементы или JSX-компоненты. Когда вложенность не выражена в разметке, разработчики чаще повторяют вызовы и HTML вручную; при изменениях эти копии приходится поддерживать отдельно. Это отличие в способе организации и повторного использования кода, а не утверждение о производительности.
Ключевое преимущество Blade — вложенность компонентов
В типовой компонентной системе Битрикса компонент подключают вызовом $APPLICATION->IncludeComponent() из PHP. Вложенный вызов возможен, но его нельзя описать в шаблоне как обычную вложенную разметку. В Blade же один компонент можно поместить внутрь другого так же естественно, как HTML-элемент или JSX-компонент в React.
Например, Hero отвечает за структуру секции и выводит содержимое своего слота:
@props(['title', 'description', 'image', 'imageAlt' => ''])
<section class="hero">
<img src="{{ $image }}" alt="{{ $imageAlt }}">
<div class="hero__content">
<h1>{{ $title }}</h1>
<p>{{ $description }}</p>
<div class="hero__actions">{{ $slot }}</div>
</div>
</section>
На странице внутрь Hero можно вложить готовые компоненты кнопок:
<x-hero
title="Сайт, который удобно развивать"
description="Соберите страницу из повторно используемых блоков."
image="/upload/hero.jpg"
image-alt="Пример страницы сайта"
>
<x-button href="/catalog/" variant="primary">Каталог</x-button>
<x-button href="/contacts/" variant="secondary">Связаться</x-button>
</x-hero>
Родитель задаёт композицию секции, а каждый дочерний компонент отвечает за собственную разметку и вариант оформления. Кнопку можно повторно использовать в карточках, формах и других секциях. Без такой композиции похожие блоки часто собирают из повторяющихся фрагментов или отдельных вызовов, и правки приходится синхронизировать вручную. Blade позволяет описать эту структуру один раз и вкладывать компоненты непосредственно в шаблон.
Вложенность особенно полезна, когда дочерние элементы повторяются или состав секции меняется. Если же часть уникальна и больше нигде не нужна, не обязательно выносить её в отдельный компонент — достаточно обычной разметки или слота.
Совместимость с современными CSS/UI библиотеками — DaisyUI & TailwindCSS
Модуль не выводит собственный HTML и не приносит своей вёрстки: x-component — это обычный файл разметки, который рендерится в страницу как есть. Поэтому в компонентах работает любая вёрстка: Tailwind CSS, DaisyUI, Bootstrap, собственные BEM-классы. В поставке нет ни сборки стилей, ни темы — только PHP-зависимости в vendor/.
DaisyUI: варианты блока через параметры
DaisyUI задаёт оформление готовыми классами (alert, btn, card, badge, steps), а вариант — суффиксом (alert-success, btn-primary). Это хорошо совпадает с параметрами Blade-компонента: страница передаёт смысл («успех», «предупреждение»), файл компонента решает, какие классы за это отвечают.
@props(['type' => 'info'])
@php
$classes = [
'info' => 'alert-info',
'success' => 'alert-success',
'warning' => 'alert-warning',
'error' => 'alert-error',
];
$alertClass = $classes[$type] ?? $classes['info'];
@endphp
<div role="alert" class="alert {{ $alertClass }} my-4">{!! $slot !!}</div>
Страница при этом остаётся короткой и не знает про CSS:
<x-alert type="success">Изменения сохранены</x-alert>
Добавить новый вариант — значит дописать строку в массив компонента, а не искать все места, где выводится уведомление.
Tailwind: шаблоны сканируются как обычная разметка
Tailwind генерирует CSS только для тех классов, которые находит в файлах проекта. X-components и x-pages лежат в document root (local/), то есть внутри той же области, которую обычно сканирует сборка, — специальных плагинов, резолверов и «безопасных списков» для модуля не нужно.
Есть ограничение, которое относится к Tailwind, а не к модулю: имя класса должно встречаться в файле целиком. Конструкция вида class="alert-{{ $type }}" в собранный CSS не попадёт — Tailwind не знает, какие значения принимает параметр. Поэтому варианты перечисляют полными именами, как в примере выше, либо добавляют их в safelist сборки.
Со стороны сервера эта связка ничего не усложняет: сборка CSS — задача проекта, а не модуля. Tailwind и DaisyUI собираются на этапе разработки, на сайт попадает готовый CSS-файл, и на сервере по-прежнему не нужны ни Composer, ни Node.js.
Слоты и атрибуты: правка страницы без правки компонента
Помимо основного и именованных слотов, компонент может принимать атрибуты, которые не описаны в @props. Достаточно вывести их в разметке:
@props(['title'])
<section {{ $attributes->class(['mb-10']) }}>
<h2 class="mb-4 text-2xl font-semibold">{{ $title }}</h2>
<div class="space-y-4 leading-7">{!! $slot !!}</div>
</section>
Тогда страница может добавить class, id или data-атрибуты, не создавая второй вариант компонента и не форкая его:
<x-section title="Доставка" class="bg-base-200 p-6" id="delivery">...</x-section>
$attributes->class() дописывает классы страницы к классам компонента, а не выводит второй атрибут class. Тот же приём работает и с утилитами Tailwind, и с модификаторами другой библиотеки: заранее закладывать все возможные классы в компонент не нужно.
Смена темы и другие библиотеки
Если в компонентах используются смысловые токены DaisyUI (bg-base-100, text-base-content, btn-primary), а не жёстко заданные цвета, смена темы (data-theme) перекрашивает все блоки сразу — компоненты про конкретную палитру не знают. Тот же принцип работает с CSS-переменными других библиотек.
Связка не привязана именно к DaisyUI. Bootstrap-сетка, готовый UI-kit, статичный CSS из макета — всё это остаётся разметкой внутри компонента, а параметры компонента описывают, что блок означает, а не как он выглядит.
Как BB Components связывает блоки, страницы и Битрикс?
Модуль соединяет три части: x-components для повторно используемых блоков, x-pages для страниц и директивы-мосты для взаимодействия со штатными возможностями Битрикса. За счёт этого Blade можно вводить точечно, а не превращать миграцию в отдельный проект по переписыванию сайта.
x-components: блоки с параметрами и слотами
Анонимный Blade-компонент — это файл в local/x-components/. Для него не нужно создавать отдельный PHP-класс компонента Битрикса.
Например, local/x-components/alert.blade.php может выглядеть так:
@props(['type' => 'info'])
<div class="alert alert-{{ $type }}">
{{ $slot }}
</div>
@props задаёт параметр type и значение по умолчанию, а $slot — место для содержимого, переданного при вызове:
<x-alert type="success">
Изменения сохранены
</x-alert>
Разметка блока остаётся в одном файле, а страница задаёт только нужный вариант и содержимое. Вложенные компоненты можно размещать по каталогам: например, x-components/forms/input.blade.php вызывается как <x-forms.input />.
x-pages: Blade-страницы на прежних URL
Blade-страницы размещаются в local/x-pages/ и повторяют структуру публичных адресов:
x-pages/index.blade.phpсоответствует главной странице/;x-pages/about/index.blade.php— странице/about/;x-pages/about/delivery/index.blade.php— странице/about/delivery/.
Модуль находит подходящую Blade-страницу и передаёт её движку. Существующий PHP-файл не нужно заменять прокси-скриптом: если убрать соответствующий x-page, прежний файл Битрикса снова обработает URL.
Так можно перенести один раздел, проверить результат и только затем двигаться дальше. Новые URL без физического PHP-файла обслуживает общее правило маршрутизации, которое модуль добавляет при установке.
Директивы-мосты: вызов штатных возможностей
Blade-страница может задавать свойства страницы и вызывать компонент Битрикса. Например:
@title('Доставка')
@pageProperty('description', 'Условия доставки заказов')
<x-alert>
Выберите удобный способ доставки при оформлении заказа.
</x-alert>
@bxComponent('bitrix:main.include', '', [
'AREA_FILE_SHOW' => 'file',
'PATH' => '/include/delivery.php',
])
Это позволяет использовать существующий компонент в новом шаблоне, не переписывая его только ради внешнего оформления. Собственные страницы и блоки можно переносить отдельно от системных компонентов.
Что входит в BB Components?
Единица поставки — установочный архив модуля BB Components версии 0.1.261031 для «1С-Битрикс». По описанию поставки, в архив входят:
- модуль
bb.componentsс установкой через административный раздел; - Blade-движок на основе
illuminate/view12; - PHP-зависимости в каталоге
vendor/— устанавливать Composer на сайт не требуется; - анонимные компоненты с параметрами, значениями по умолчанию, слотами и вложенными компонентами;
- маршрутизация Blade-страниц из
local/x-pages/; - директивы
@bxComponent,@titleи@pageProperty; - классический компонент Битрикса
bb:button, шаблон которого использует Blade; - страница настроек с путями к каталогам и очисткой кэша скомпилированных шаблонов;
- инструкция по установке и проверке.
Как безопасно попробовать подход на одной странице?
1. Начните с тестового контура
Распакуйте архив в local/modules/bb.components/, затем установите модуль через административный раздел. Перед установкой на рабочем сайте сделайте резервную копию и проверьте совместимость окружения.
Для первого переноса выберите страницу без сложной динамической логики. Так проще сравнить поведение нового шаблона с исходным и локализовать возможные проблемы.
2. Вынесите один повторяющийся блок
Создайте файл в local/x-components/, задайте параметры через @props, а место для передаваемого содержимого — через $slot. Начните с блока, который действительно повторяется или имеет несколько вариантов; не дробите страницу на десятки компонентов заранее.
3. Создайте Blade-страницу на том же URL
Добавьте файл в local/x-pages/, перенесите содержимое и подключите необходимые компоненты Битрикса через @bxComponent. Нативную PHP-страницу пока сохраните: она пригодится для сравнения и отката.
4. Сравните результат и проверьте кэш
Проверьте заголовок страницы, метаданные, HTML, формы и динамические компоненты. Если отображение зависит от авторизации, сравните страницу для авторизованного и неавторизованного пользователя.
После правок при необходимости очистите кэш скомпилированных шаблонов в настройках модуля. Во время разработки движок также отслеживает время изменения исходного шаблона.
5. Переносите следующий блок только после проверки
Если страница работает ожидаемо, используйте компонент в других местах. Для отката конкретной страницы удалите её x-page: штатный PHP-файл продолжит обрабатывать прежний URL.
Кому подходит BB Components — и кому нет?
Модуль стоит рассмотреть, если команда:
- разрабатывает и поддерживает собственные шаблоны на «1С-Битрикс»;
- хочет описывать повторяющиеся блоки через параметры и слоты;
- предпочитает переносить страницы постепенно, а не переписывать сайт целиком;
- готова редактировать Blade-файлы в коде;
- использует PHP 8.2 или новее — эта версия окружения указана среди проверенных.
Это инструмент для разработчика, а не библиотека готового дизайна и не визуальный конструктор. Модуль не создаёт страницы без участия разработчика и не заменяет компоненты магазина или редактор контента.
Какие ограничения важно учесть?
- Визуальный редактор не становится редактором Blade-компонентов. Чистые x-components не отображаются в нём как компоненты Битрикса. Редактор продолжает работать с исходной нативной страницей, а Blade-содержимое находится в x-page.
- Системные страницы не обязательно переносить. Например,
/auth/остаётся нативной. Каталог, корзину и оформление заказа можно подключать через мосты, но переписывание их внутренних шаблонов — отдельная задача. - Маршрутизация новых URL зависит от
urlrewrite.php. Изменения в административном разделе «Обработка адресов» могут перезаписать правило; после них маршрутизацию нужно проверить. - Пути каталогов общие для установки. В текущей версии отдельные пути
x-componentsиx-pagesдля разных сайтов в многосайтовой конфигурации не предусмотрены. - Совместимость библиотек требует проверки. Если в проекте уже загружена другая версия Illuminate, совместную работу нужно проверить на копии сайта.
- Композитный режим не входил в проверку версии
0.1.261031. Для страниц с HTML-кэшем и динамическими зонами нужна отдельная проверка в вашей конфигурации.
Ответы на вопросы
Нужно ли устанавливать Laravel?
Нет. Модуль использует standalone-компонент illuminate/view, а не полноценное Laravel-приложение. Необходимые зависимости включены в архив.
Нужен ли Composer на сервере?
Нет. Для установки готового архива достаточно скопировать модуль и запустить установку в админке. Composer нужен только при повторной сборке зависимостей для разработки поставки.
Придётся ли отказаться от компонентов Битрикса?
Нет. Директива @bxComponent позволяет вызывать компоненты Битрикса из Blade-шаблона. Можно сохранить существующие компоненты и переносить только выбранные страницы и шаблоны.
Изменятся ли адреса страниц?
При использовании x-pages структура повторяет существующие публичные URL. Поэтому перенос страницы на Blade не требует менять её адрес.
Можно ли вернуться к PHP-странице?
Да. Для отката удалите соответствующий x-page: прежний PHP-файл продолжит обрабатывать URL. При удалении модуля регистрация снимается, а созданные каталоги данных и скопированные компоненты остаются; после проверки их можно удалить вручную.
Подойдёт ли модуль контент-менеджеру без разработчика?
Нет. Для создания компонентов и переноса страниц нужно работать с PHP- и Blade-файлами. Первоначальную настройку выполняет разработчик.
Коротко: что важно знать
- Blade-компоненты помогают вынести повторяющуюся разметку в отдельные шаблоны с параметрами и слотами.
- Это полезно, когда блок действительно повторяется или имеет несколько вариантов; уникальную разметку не обязательно превращать в компонент.
- BB Components связывает компоненты, Blade-страницы и вызовы штатных компонентов Битрикса.
- Перенос можно начать с одной страницы, не меняя её публичный URL, и сохранить PHP-вариант для сравнения и отката.
- Модуль рассчитан на разработчиков, не заменяет визуальный редактор и требует проверки на тестовом контуре.
- Совместимость, ограничения конфигурации и условия лицензии нужно сверить до покупки.