FCIBlockSection::GetNavChain

Описание

Метод статический: Предназначен для получения навигационной цепочки (breadcrumb) от текущего раздела к корневому. Поддерживает мультиязычность: при указании параметра LANGUAGE_ID возвращаются переведённые названия разделов. Переопределяет базовый метод CIBlockSection::GetNavChain и расширяет его возможностями мультиязычного вывода данных.

Сигнатура метода

Code Copy code Code copied! 
1
2
3
4
5
6
7
8

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 — возвращается массив с результатами.

Пример

Code Copy code Code copied! 
1
2
3
4
5
6
7
8
9
10
11

// Получаем навигационную цепочку на английском языке
$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 в официальной документации Битрикс

Количество показов: 448
Дата изменения: 23.06.2025 13:32:34