FCIBlockSection::GetList

Описание

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

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

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

FCIBlockResult
FCIBlockSection::GetList(
 array $arOrder = ["SORT" => "ASC"],
 array $arFilter = [],
 bool $bIncCnt = false,
 array $arSelect = [],
 mixed $arNavStartParams = false,
 string $LANGUAGE_ID = LANGUAGE_ID
);

Параметры вызова

Параметр Описание С версии
arOrder Массив для сортировки результата. Ключ — поле сортировки, значение — направление (ASC или DESC). 1.0.0
arFilter Массив условий фильтрации разделов. Поддерживаются стандартные поля и свойства разделов. 1.0.0
bIncCnt Учитывать количество элементов в подразделах при подсчёте количества элементов в разделе. 1.0.0
arSelect Массив полей для выборки. Если не задан, выбираются все стандартные поля. 1.0.0
arNavStartParams Массив параметров постраничной навигации или false для отключения. Позволяет получить только часть результата. 1.0.0
LANGUAGE_ID Код языка, например, 'en', 'de', 'id'. Используется для получения переведённых данных разделов. Если параметр не указан — используется язык текущего сайта из глобальной константы LANGUAGE_ID. 2.5.100

Возвращаемое значение

Метод возвращает объект FCIBlockResult — результат ORM-запроса, содержащий список разделов на нужном языке. Для перебора результатов используется GetNext(). В случае ошибки возвращается false.

Пример

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

// Получаем все активные разделы с выборкой имени на английском языке
$arOrder = ['SORT' => 'ASC'];
$arFilter = ['ACTIVE' => 'Y'];
$arSelect = ['ID', 'NAME'];
$LANG = 'en';

$res = FCIBlockSection::GetList($arOrder, $arFilter, false, $arSelect, false, $LANG);

while ($arSection = $res->GetNext()) {
    echo $arSection['NAME'] . "<br>";
}

Примечание: Метод учитывает язык при выборке полей и возвращает переведённые данные, если они доступны. Для повышения производительности рекомендуется явно указывать список необходимых полей в $arSelect.

Описание метода CIBlockSection::GetList в официальной документации Битрикс

Количество показов: 661
Дата изменения: 23.06.2025 13:31:16