Описание
Метод статический: Получает список свойств элемента инфоблока с учётом фильтра и порядка сортировки.
Поддерживает мультиязычность: при передаче параметра $LANGUAGE_ID
возвращает значения свойств на соответствующем языке (если доступны переводы).
Переопределяет базовый метод CIBlockElement::GetProperty.
Сигнатура метода
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()
.
Если переведённые значения не заданы, возвращаются оригинальные данные.
Пример
// Получаем свойства элемента на французском языке $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 в официальной документации Битрикс
Количество показов: 540
Дата изменения: 23.06.2025 13:37:52