Документация для разработчиков

GetDisplayValue

array CIBlockFormatProperties::GetDisplayValue(
  array arItem, 
  array arProperty, 
  string event1
)
 

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

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

Параметр Описание
arItemМассив полей элемента.
arProperty Массив полей свойства (как его возвращает метод CIBlockElement::GetProperty).
event1 Метка для создания события перехода по ссылке в случае, когда установлен модуль Веб-аналитика.

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

Массив полей элемента.

Примечание: метод в поле DISPLAY_VALUE выводит только активные по дате элементы (используется фильтр на уровне ядра, поэтому вывести ссылки на неактивные элементы не получится стандартными средствами).



Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Сергей Куняев
Если выводимое свойство содержит 1 значение, например, файл, то метод вернет массив файла, если больше, то ассоциативный массив описаний файлов.  
При выводе в шаблоне следует проверять, делать foreach или нет, если ожидается несколько значений.
************************
Комментарий разработчика: справедливо ен только для файлов, но вообще для всех типов.
************************

Фрагмент кода метода, отвечающий за неоднозначность:

Код
   if ($arProperty["PROPERTY_TYPE"]=="F")
     {
      $fileCount = count($arFiles);
      if ($fileCount == 1)
          $arProperty["FILE_VALUE"] = $arFiles[0];
      elseif ($fileCount > 1)
          $arProperty["FILE_VALUE"] = $arFiles;
      else
          $arProperty["FILE_VALUE"] = false;
     }
 
© «Битрикс», 2001-2019, «1С-Битрикс», 2019
Наверх