Описание
Метод статический: Предназначен для получения списка разделов информационного блока с учетом фильтрации, сортировки и постраничной навигации.
Поддерживает мультиязычность: при указании параметра LANGUAGE_ID
возвращаются поля разделов на соответствующем языке.
Переопределяет базовый метод CIBlockSection::GetList и расширяет его функциональность возможностью получения переведённых данных.
Сигнатура метода
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
.
Пример
// Получаем все активные разделы с выборкой имени на английском языке $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 в официальной документации Битрикс
Количество показов: 442
Дата изменения: 23.06.2025 13:31:16