FCIBlockElement::GetProperty

Описание

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

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

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

CDBResult
FCIBlockElement::GetProperty(
 int $IBLOCK_ID,
 int $ELEMENT_ID,
 string $by = "sort",
 string $order = "asc",
 array $arFilter = [],
 string $LANGUAGE_ID = LANGUAGE_ID
);

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

Параметр Описание С версии
IBLOCK_ID Идентификатор инфоблока, к которому относится элемент. 1.0.0
ELEMENT_ID Идентификатор элемента инфоблока, свойства которого нужно получить. 1.0.0
by Поле для сортировки свойств (например, 'sort', 'name'). 1.0.0
order Направление сортировки: 'asc' — по возрастанию, 'desc' — по убыванию. 1.0.0
arFilter Массив фильтра для ограничения набора свойств. Можно задать по CODE, ID и другим параметрам. 1.0.0
LANGUAGE_ID Код языка, для которого требуется получить переведённые значения свойств. Если не указан — используется текущий язык сайта. 2.5.100

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

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

Пример

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

// Получаем свойства элемента на французском языке
$IBLOCK_ID = 12;
$ELEMENT_ID = 678;
$LANG = 'fr';

$res = FCIBlockElement::GetProperty($IBLOCK_ID, $ELEMENT_ID, 'sort', 'asc', [], $LANG);

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

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

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

Количество показов: 693
Дата изменения: 23.06.2025 13:37:52