filter — работа с инфоблоками: списки, детальные, разделы, таблицы, календари, фильтрlink

Это базовый набор компонентов SF4 для чтения и вывода контента из инфоблоков в наиболее частых форматах:

simai:sf.iblock.list — вывод списка элементов (каталоги, новости, карточки, ленты).
simai:sf.iblock.detail — детальная страница элемента (карточка, статья, запись).
simai:sf.iblock.section — вывод разделов и вложенных элементов (разделы каталога, структуры).
simai:sf.iblock.table — табличный вывод (когда важны колонки и сортировка).
simai:sf.iblock.calendar — календарное представление событий.
simai:sf.iblock.filter — фильтрация элементов инфоблока (обычно в связке со списком/таблицей).

Важная деталь для документации и настройки: в sf.iblock.list предусмотрены параметры идентификации инфоблока как по ID, так и по коду (встречаются параметры IBLOCK_ID, IBLOCK_CODE, IDENTIFICATION_TYPE), плюс типовые параметры сортировки (SORT_BY1/2, SORT_ORDER1/2), секций (SECTION_ID, SECTION_CODE), фильтра (FILTER_NAME, FILTER), цепочки/SEO (SET_TITLE, SET_BROWSER_TITLE, SET_META_*) и кэша (CACHE_TIME, CACHE_FILTER, CACHE_GROUPS).

Пример минимального подключения списка (значения — шаблоны, подставляются под ваш проект):

<?php

declare(strict_types=1);

$APPLICATION->IncludeComponent(
    'simai:sf.iblock.list',
    '.default',
    [
        'IBLOCK_TYPE' => '<тип_инфоблока>',
        'IBLOCK_ID' => <id_инфоблока>,
        'SECTION_ID' => 0,
        'COUNT' => 10,
        'SORT_BY1' => 'SORT',
        'SORT_ORDER1' => 'ASC',

        // Если используете фильтр:
        // 'FILTER_NAME' => 'arrFilter',

        'CACHE_TIME' => 3600,
        'CACHE_FILTER' => 'Y',
        'CACHE_GROUPS' => 'Y',
    ]
);

sf.highloadblock.grid — вывод таблицы HL-блокаlink

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

На практике компонент удобно применять как “табличное представление” для административных и пользовательских экранов, где HL-блок выступает источником данных, а SF4 даёт единый стиль и интеграцию с остальными частями интерфейса.

sf.grid — сборка страницы из строк/колонок (грид)link

simai:sf.grid — ключевой компонент SF4 для построения структуры страницы (или области страницы) из строк/колонок и “area-выводов”. Он используется как “движок компоновки”: получает параметры структуры (сколько строк, как разбиты колонки, какие area-шаблоны вывести) и рендерит итоговую разметку.

В текущей модели SF4 грид чаще выступает как исполняемый конфиг: представление (view) хранит/генерирует набор параметров и внутри template.php выполняет вызов simai:sf.grid уже с готовой конфигурацией области (header/footer/sidebar/main…). Из “базовых” параметров компонента явно встречаются ROW_COUNT, ROW_ORDER, а также параметры, связанные с модификаторами/фоном (BLOCK_MODIFIER, USE_BACKGROUND, BACKGROUND_TEMPLATE) и режимами (ANIMATE_MODE, EXPERT_MODE). При этом основная масса параметров структуры (ROW/COL/AREA) формируется динамически и передаётся как набор ключей.

sf.block/sf.block.view/sf.block.property/sf.block.edit/sf.block.row.property/sf.block.col.property — вывод блоков и формы настройки блоков/рядов/колонокlink

Эта группа компонентов относится к “конструктору блоков” и режимам редактирования SF4:

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

Практически это означает: пользователь/администратор меняет настройки в панели, а эти компоненты обеспечивают единый UI и сохранение параметров, которые затем используются при рендере view/grid.

sf.block.row/col (если есть) — структурные компоненты ряда/колонкиlink

Не найдено в локальных данных: компоненты с именами simai:sf.block.row и simai:sf.block.col как отдельные сущности.

Роль “структурных” частей (ряд/колонка) в SF4 закрывается самим simai:sf.grid и связанными property/edit-компонентами (настройки рядов/колонок), поэтому в документации лучше опираться на sf.grid + sf.block.*.property, а отдельные sf.block.row/col упоминать только если они реально присутствуют в вашей поставке.

sf.feedback / sf.feedback.appeal / sf.feedback.vote / sf.message — формы обратной связи/обращения/опроса/уточненияlink

Это прикладные компоненты SF4 для коммуникаций и интерактивных сценариев:

simai:sf.feedback — настраиваемая форма обратной связи.
simai:sf.feedback.appeal — форма обращения/заявки.
simai:sf.feedback.vote — голосование/опрос по элементам инфоблока.
simai:sf.message — форма уточнения/ответа по обращению.

В документации решения полезно отделять “UI формы” от “маршрута обработки”: куда уходит обращение (почта/БД/инфоблок/HL/тикеты) зависит от настройки решения и требует описания на уровне проекта (а не только компонента).

sf.menu.sections / menu.list / sf.breadcrumb — меню и хлебные крошкиlink

В SF4 используются как собственные, так и “битриксовые” по смыслу компоненты меню, но приведённые к единой модели вывода:

simai:sf.menu.sections — динамическое меню по разделам инфоблока.
bitrix:menu.list (в поставке присутствует как menu.list) — динамическое меню по элементам инфоблока (пункты строятся из элементов).
simai:sf.breadcrumb — “хлебные крошки” (цепочка навигации).
bitrix:pagenavigation (в поставке как pagenavigation) — кастомизация пагинатора/навигации по страницам.

Не найдено в локальных данных: компонент с именем breadcrumb (как отдельный компонент). Для хлебных крошек в SF4 используется именно simai:sf.breadcrumb.

sf.weather / sf.rss.show / sf.share / sf.cookie.notification / sf.up / sf.promo / sf.banner.main / sf.pdf.viewer — виджеты и служебные блокиlink

Это “готовые кирпичи” для типовых функций сайта:

simai:sf.weather — отображение погоды.
simai:sf.rss.show — вывод RSS-ленты.
simai:sf.share — иконки/кнопки шеринга.
simai:sf.cookie.notification — уведомление о cookies с подтверждением.
simai:sf.up — кнопка прокрутки наверх.
simai:sf.promo — промо-блок/баннеры (универсальный вывод промо-сущностей).
simai:sf.banner.main — динамические баннеры на главной.
simai:sf.pdf.viewer — встроенный просмотр PDF-файлов.

Их обычно подключают внутри блоков (как часть grid/block), чтобы виджет был “встроен” в архитектуру областей и наследовал общие настройки/ассеты проекта.

sf.property.edit / sf.wizard / sf.wizard.stage / sf.swiper.nav / task.selector — редакторы, мастер, вспомогательные UIlink

Эта группа компонентов обеспечивает интерфейсы настройки и инфраструктуру сценариев:

simai:sf.property.edit — редактор свойств (форма настроек/универсальных свойств).
simai:sf.wizard — основной компонент пошагового мастера.
simai:sf.wizard.stage — вывод отдельного шага мастера.
simai:sf.swiper.nav — шаблоны навигации Swiper (стрелки/пагинация/контролы).
simai:task.selector — компонент выбора задачи (сценарий использования требует уточнения, но компонент присутствует).

Пример запуска мастера из установщика решения (параметры соответствуют реальной схеме компонента sf.wizard):

<?php

declare(strict_types=1);

$APPLICATION->IncludeComponent(
    'simai:sf.wizard',
    '.default',
    [
        'WIZARD_DIR' => $dirWizard,
        'WIZARD_CONFIG_FILE' => $dirWizard . '/.wizard.config.php',

        'AJAX_TIME_STEP' => 3,
        'AJAX_TIME_INTERVAL' => 1,
        'AJAX_MODE' => 'Y',
    ],
    false
);

Где искать компонент и как понимать “каноническое имя”link

Каноническое имя компонента в подключении строится как simai:<код_компонента>, где <код_компонента> соответствует папке компонента в /bitrix/components/simai. Для документации и поддержки это важно: если в проекте переопределяется шаблон компонента, меняется именно шаблон/параметры, но сам компонент остаётся тем же — это помогает удерживать единый каталог возможностей SF4 и корректно обновляться.