home chevron_right
Назначение и краткие аннотации (по компонентам SF4)

Компоненты SF4 устанавливаются в /bitrix/components/simai и подключаются стандартно через IncludeComponent() с префиксом simai: (например, simai:sf.grid). Часть компонентов ориентирована на публичную часть сайта (сборка страниц, блоки, меню, виджеты), часть — на служебные интерфейсы (настройки, гриды/фильтры, мастер).

Ниже — группировка по назначению. Если у компонента есть несколько сценариев (публичный вывод + редактирование), это отмечено в описании.

Iblock: вывод и сценарии работы с инфоблокамиlink

simai:sf.iblock.list Компонент для вывода списка элементов инфоблока. Внутри используется API инфоблоков (включая выборку элементов, работу с фильтрацией/сортировкой, секциями и формирование результата для шаблона). В режиме редактирования/разработки у компонентов этого семейства обычно отключается кэширование, чтобы изменения в данных/настройках были видны сразу.

simai:sf.iblock.detail Детальная страница элемента инфоблока. Типовой сценарий — получить элемент по параметрам, собрать поля/свойства в $arResult и отрисовать шаблоном.

simai:sf.iblock.section Вывод разделов и/или элементов в контексте раздела. Полезен для страниц каталога/разделов, где важна привязка к SECTION_ID и навигация по структуре.

simai:sf.iblock.table Вывод элементов в табличном виде. Используется там, где контент должен читаться как список строк (например, справочники, перечни документов, расписания и т.п.).

simai:sf.iblock.calendar Представление контента инфоблока в календарной логике (с датами, диапазонами, группировкой по дням/месяцам). Внутри задействуются даты/время и подготовка структуры данных под календарный шаблон.

simai:sf.iblock.filter Формирует фильтр по инфоблоку (поля/свойства → параметры фильтра). Обычно используется совместно со списками/таблицами, чтобы пользователь мог ограничить выдачу.

simai:property.news.calendar Специализированный компонент “календарного” поведения для новостей/публикаций, завязанный на инфоблок. По сути — готовый сценарий календарной навигации/отбора для новостных сущностей.

Highloadblock: таблица HL-блокаlink

simai:sf.highloadblock.grid Универсальный вывод данных HL-блока в формате грида: поддерживает настройку отображаемых полей, фильтрацию, сортировку и постраничную навигацию. Это “готовая таблица” для HL-сущностей, которую можно быстро подключить на страницу и управлять выводом параметрами компонента.

Grid и блоки: сборка страницы и редакторы параметровlink

simai:sf.grid Основной компонент сборки страницы на базе 12-колоночной сетки (bootstrap-логика). Он работает с представлениями (view) и блоками (block) из проектного слоя сайта и собирает итоговую разметку из строк/колонок/областей. В параметрах компонента присутствуют управляющие сущности вроде секции блоков (например, BLOCK_SECTION) и числовые/структурные параметры сборки.

simai:sf.block Компонент для вывода блока как самостоятельной единицы. Используется, когда блок нужно отрисовать отдельно или когда сборщик страницы делегирует рендер конкретного блока в специализированный компонент. Также учитывает режим разработки (например, отключение кэша при development_mode).

simai:sf.block.view Компонент “представления блока/области” — помогает связать настройки текущей страницы/области с набором блоков и подготовить данные для вывода. По факту это слой, который читает конфигурацию и формирует структуру для шаблона.

simai:sf.block.edit Компонент режима редактирования блока (визуальный/inline сценарий). Его задача — обслуживать UI правки параметров и обновления конфигурации блока при включённом режиме редактирования.

simai:sf.block.property Форма/интерфейс редактирования параметров конкретного блока. Используется в составе редактора, когда нужно “раскрыть” настройки блока и сохранить изменения.

simai:sf.block.row.property и simai:sf.block.col.property Аналогичные формы, но для параметров ряда и колонки. Это важно, потому что в SF4 редактируются не только блоки, но и контейнерные сущности (row/col): фон/отступы/адаптивность/условия показа и т.д.

Feedback и сообщения: формы и отправка событийlink

simai:sf.feedback Форма обратной связи. Внутри есть логика подготовки полей, валидации и отправки (используется почтовое событие Bitrix). Также подключаются служебные функции (в т.ч. фильтрация текста), а настройки безопасности могут зависеть от параметров сайта (например, reCAPTCHA через свойства).

simai:sf.feedback.appeal Вариант формы “обращение” (по структуре близок к feedback), с собственными текстами/полями и логикой подтверждения/валидации.

simai:sf.feedback.vote Форма “голосование/оценка”. Использует параметры сайта для антиспама (reCAPTCHA), собирает результаты, отправляет уведомление и/или сохраняет данные по сценарию компонента.

simai:sf.message Компонент отправки сообщения в авторизованном режиме: в коде явно проверяется авторизация пользователя, дальше отрабатывает логика отправки/сохранения/уведомления (в зависимости от параметров).

simai:feedback.error Служебный компонент для отправки сообщения об ошибке: принимает данные об ошибке из запроса и инициирует почтовое событие (например, чтобы уведомить поддержку о проблеме на странице).

Навигация и менюlink

simai:sf.menu Компонент меню с поддержкой уровней вложенности и дополнительных настроек. Работает как “расширенный” слой над типовым меню, формируя структуру для шаблона.

simai:sf.menu.sections Меню, ориентированное на разделы/структуру (часто используется как боковая навигация по разделам).

simai:menu.list Компонент списка пунктов меню (служебный/утилитарный). Удобен, когда нужно вывести меню в “простом” формате без усложнённой логики.

simai:sf.breadcrumb Хлебные крошки: формирует цепочку навигации и подключает стили шаблона компонента.

simai:pagenavigation Постраничная навигация. Используется в связке со списками/таблицами, когда нужна унифицированная разметка пагинации.

simai:sf.section.main.map Компонент карты/дерева разделов (по смыслу — построение структуры навигации по разделам, с управлением глубиной и типами меню).

Контентные виджеты и UI-элементыlink

simai:sf.banner.main Компонент главного баннера (герой-блок/промо-область). Обычно используется в ключевых областях страницы.

simai:sf.promo Промо-блок/виджет для акций, сообщений, выделенных карточек (конкретная визуализация задаётся шаблоном).

simai:sf.share Кнопки шаринга/социальные действия.

simai:sf.cookie.notification Уведомление о cookie (публичный UI-виджет).

simai:sf.up Кнопка “вверх” (UI-поведение, обычно завязано на JS/шаблон).

simai:sf.swiper.nav Навигация для слайдера (управляющие элементы: стрелки/пагинация — в зависимости от шаблона).

simai:sf.rss.show Вывод RSS-ленты (или подготовка/обработка RSS-данных под шаблон). Используется там, где нужно показать внешние/внутренние RSS-источники.

simai:sf.weather Виджет погоды: использует справочник городов и формирует данные под шаблон. Кэш по умолчанию ориентирован на “короткий”, чтобы погода обновлялась регулярно.

simai:sf.pdf.viewer Просмотр PDF: есть проверка валидности URL (локальный файл или внешний адрес), подготовка ссылки и безопасный вывод viewer-страницы/шаблона.

Шаблоны, справка, служебные выводыlink

simai:sf.template.include Утилитарный include: по параметру INCLUDE_PATH подключает template.php из указанного каталога (если файл существует). Полезно для “плагинных” вставок шаблонов без копирования логики в layout.

simai:info.help Компонент справки/подсказок, который подтягивает контент из инфоблока и подключает нужные ассеты для визуализации (например, счётчики/анимации в шаблоне).

Настройки и редакторы конфигурацииlink

simai:sf.property.edit Универсальный редактор свойств по конфигурации, получаемой через параметры компонента. Поддерживает разные типы полей, включая сценарии “редакторов” (например, когда нужно править содержимое файлов/скриптов через UI). Это один из ключевых строительных блоков “панели управления” SF4.

Wizard (мастер установки/обновления)link

simai:sf.wizard Универсальный мастер: управляет стадиями, хранит конфигурацию и состояние, исполняет действия и переключает шаги. Внутри явно описывается модель результата: конфиг мастера, текущая стадия, статус стадии, текущая action-конфигурация и её данные.

simai:sf.wizard.stage Компонент шага мастера: отвечает за отрисовку конкретной стадии/шага и его UI (кнопки, сообщения, прогресс, ввод параметров — в зависимости от сценария мастера).

UI-инфраструктура: гриды и фильтрыlink

simai:main.ui.grid Компонент на базе Bitrix\Main\Grid для отображения табличных данных с колонками, сортировкой, действиями и шаблонами вывода (включая альтернативные шаблоны вроде tile-вида). Полезен как унифицированная “таблица” для публичных и служебных интерфейсов SF4.

simai:main.ui.filter Фильтр для гридов/списков: формирует UI фильтрации и взаимодействует с гридом (сохранение/загрузка настроек, применение условий).