Blade-компоненты для «1С-Битрикс»: зачем они нужны и как внедрить их постепенно

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

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/view 12;
  • 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-вариант для сравнения и отката.
  • Модуль рассчитан на разработчиков, не заменяет визуальный редактор и требует проверки на тестовом контуре.
  • Совместимость, ограничения конфигурации и условия лицензии нужно сверить до покупки.

Ответить