FCIBlockElement::GetElementGroups

Описание

Метод статический: Возвращает список групп (разделов) инфоблока, к которым принадлежит элемент с указанным идентификатором. Переопределяет базовый метод CIBlockElement::GetElementGroups и поддерживает мультиязычность: при передаче параметра $LANGUAGE_ID или по языку сайта возвращаются переведённые названия разделов.

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

Code Copy code Code copied!
1
2
3
4
5
6
7
CIBlockResult
FCIBlockElement::GetElementGroups(
 int $ID,
 bool $bElementOnly = false,
 array $arSelect = [],
 string $LANGUAGE_ID = LANGUAGE_ID
);

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

Параметр Описание С версии
ID Идентификатор элемента инфоблока, для которого необходимо получить группы. 2.5.765
bElementOnly Если true — возвращаются только группы, напрямую связанные с элементом. Если false — возвращаются также родительские группы по иерархии. 2.5.765
arSelect Массив полей, которые необходимо выбрать у разделов. Например, ['ID', 'NAME']. 2.5.765
LANGUAGE_ID Код языка, на котором следует вернуть переведённые данные. Если не указан — используется текущий язык сайта. 2.5.765

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

Метод возвращает объект CIBlockResult, содержащий список разделов инфоблока, в которых размещён элемент. При передаче параметра $LANGUAGE_ID названия групп возвращаются на соответствующем языке (если переводы доступны). Используйте GetNext() для перебора.

Пример

Code Copy code Code copied!
1
2
3
4
5
6
7
8
9
10
// Получаем группы элемента на английском языке
$elementID = 123;
$arSelect = ['ID', 'NAME'];
$LANG = 'en';

$res = FCIBlockElement::GetElementGroups($elementID, false, $arSelect, $LANG);

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

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

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

Количество показов: 534
Дата изменения: 23.06.2025 14:13:45