Что такое «Простой компонент Битрикс»

Простые компоненты — основной строительный материал страниц. Список новостей на главной, блок «Похожие товары», форма подписки, хлебные крошки — всё это отдельные компоненты со своими параметрами и шаблоном. Их подключают вызовом $APPLICATION->IncludeComponent() в любом месте страницы или шаблона сайта.

Название противопоставляет их комплексным компонентам. Комплексный обслуживает целый раздел: смотрит на адрес и решает, показать список, рубрику или карточку. Простой ничего не решает про маршрутизацию — получает параметры и выводит результат. Внутри комплексного работают как раз простые: bitrix:news вызывает news.list и news.detail.

Из чего состоит

  • .description.php — название и место в дереве компонентов визуального редактора;
  • .parameters.php — какие параметры показывать в окне настройки;
  • class.php или component.php — логика: выбрать данные и положить их в $arResult;
  • templates/.default/ — шаблон компонента, который превращает данные в HTML.

Пример своего компонента

Собственные компоненты кладут в /local/components/ под пространством имён проекта. Логика в классе с кэшированием выглядит так:

class LastNewsComponent extends CBitrixComponent
{
    public function executeComponent()
    {
        if ($this->startResultCache()) {
            // loadItems() — свой метод с выборкой из инфоблока
            $this->arResult['ITEMS'] = $this->loadItems($this->arParams['COUNT']);
            $this->includeComponentTemplate();
        }
    }
}

Пока кэш действителен, выборка и шаблон не выполняются вовсе: компонент отдаёт готовый HTML. Это главная причина оформлять код компонентом, а не вставлять запросы прямо в страницу.

Когда простой компонент — правильный выбор

Если блок нужен на одной-двух страницах и не имеет собственных адресов, комплексный компонент избыточен. Если же нужна связка «список → рубрика → карточка» с ЧПУ, лучше собрать комплексный из простых, чем писать маршрутизацию вручную. Такие решения — обычная часть доработки сайта на 1С-Битрикс.

Связанные термины

Обновлено: 10 октября 2026

Все термины раздела «1С-Битрикс» ↗