Описание
Метод статический: Предназначен для получения навигационной цепочки (breadcrumb) от текущего раздела к корневому. Поддерживает мультиязычность: при указании параметра LANGUAGE_ID
возвращаются переведённые названия разделов. Переопределяет базовый метод CIBlockSection::GetNavChain и расширяет его возможностями мультиязычного вывода данных.
Сигнатура метода
FCIBlockResult FCIBlockSection::GetNavChain( int $IBLOCK_ID, int $SECTION_ID, array $arSelect = [], bool $arrayResult = false, string $LANGUAGE_ID = LANGUAGE_ID );
Параметры вызова
Параметр | Описание | С версии |
---|---|---|
IBLOCK_ID |
Идентификатор инфоблока. Может быть равен 0 — тогда будет определён автоматически по разделу.
|
1.0.0 |
SECTION_ID | Идентификатор раздела, с которого начинается построение навигационной цепочки. | 1.0.0 |
arSelect |
Массив полей для выборки. Если не задан — выбираются стандартные поля: ID , NAME , DEPTH_LEVEL .
|
1.0.0 |
arrayResult |
Если true — метод вернёт массив с результатом. Если false — вернёт FCIBlockResult для итерации методом GetNext() .
|
1.0.0 |
LANGUAGE_ID |
Код языка (например, 'en' , 'de' , 'id' ). При указании возвращаются переведённые поля. Если не указан — используется текущий язык сайта из глобальной константы LANGUAGE_ID .
|
2.5.100 |
Возвращаемое значение
Если параметр $arrayResult = false
, метод возвращает объект FCIBlockResult, содержащий цепочку разделов на нужном языке. Для получения результатов используется метод GetNext()
. Если $arrayResult = true
— возвращается массив с результатами.
Пример
// Получаем навигационную цепочку на английском языке $IBLOCK_ID = 10; $SECTION_ID = 145; $arSelect = ['ID', 'NAME']; $LANG = 'en'; $res = FCIBlockSection::GetNavChain($IBLOCK_ID, $SECTION_ID, $arSelect, false, $LANG); while ($arSection = $res->GetNext()) { echo $arSection["NAME"] . " > "; }
Примечание: Метод возвращает активные разделы от текущего к корню. Если переводы для разделов не заданы, будут возвращены оригинальные значения.
Описание метода CIBlockSection::GetNavChain в официальной документации Битрикс
Количество показов: 432
Дата изменения: 23.06.2025 13:32:34