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

Таблица сравнения


Описание catalog.compare.result

Компонент выводит таблицу сравниваемых элементов. Компонент стандартный, входит в дистрибутив модуля и содержит два шаблона: .default и bootstrap_v4.

В визуальном редакторе компонент расположен по пути Контент > Каталог > Таблица сравнения.

Компонент относится к модулю Информационные блоки.



Параметры

ПолеПараметрОписание
Источник данных
Уникальное имя для списка сравненияNAMEЗадается имя переменной, в которой передается список сравниваемых элементов. По умолчанию CATALOG_COMPARE_LIST.
Тип инфо-блокаIBLOCK_TYPEУказывается один из созданных в системе типов информационных блоков.
Инфо-блокIBLOCK_IDДля выбранного типа инфоблоков указывается идентификатор информационного блока, элементы которого будут отфильтрованы.
ПоляFIELD_CODEУказываются поля элементов (товаров), по которым будет происходить сравнение в таблице сравнения. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив:
Array("NAME","PREVIEW_TEXT","PREVIEW_PICTURE","DETAIL_TEXT",""),
При выборе пункта (не выбрано)-> и без указания полей в строках (т.е. если задан пустой массив), будут выведены поля по умолчанию.
СвойстваPROPERTY_CODEУказываются свойства инфоблока, которые будут отображены при показе в качестве полей фильтра. Заполняется из публичной части редактора, удерживая клавишу Ctrl либо в коде, указывая массив. При выборе пункта (не выбрано)-> и без указания кодов свойств в строках, свойства выведены не будут.
Поля предложенийOFFERS_FIELD_CODEВыбираются поля предложений. С помощью клавиши Ctrl можно выбрать несколько значений. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.
Свойства предложенийOFFERS_PROPERTY_CODEУказываются свойства предложений. Можно добавлять свои. Данный параметр появляется при настройке компонента на инфоблок с поддержкой SKU.
По какому полю сортируем элементыELEMENT_SORT_FIELDУказывается поле, по которому будет происходить сортировка элементов:
  • shows – по количеству просмотров в среднем;
  • sort – по индексу сортировки;
  • timestamp_x – по дате изменения;
  • name – по названию;
  • id – по идентификатору;
  • active_from – по дате активности с;
  • active_to – по дате активности по;
  • CATALOG_AVAILABLE – по доступности к покупке.
  • SCALED_PRICE_[ID] – по типу цен (вместо [ID] - идентификатор типа цены)
Порядок сортировки элементовELEMENT_SORT_ORDERЗадается порядок сортировки элементов:
  • ascПо возрастанию;
  • descПо убыванию.
Внешний вид
Цветовая темаTEMPLATE_THEMEЗадается цветовая схема для отображения таблицы сравнения. По умолчанию используется синяя схема (blue).
Управление режимом AJAX
Включить режим AJAXAJAX_MODE[Y|N] При установленной опции для компонента будет включен режим AJAX.
Включить прокрутку к началу компонентаAJAX_OPTION_JUMP[Y|N] Если пользователь совершит AJAX-переход, то при установленой опции по окончании загрузки произойдет прокрутка к началу компонента.
Включить подгрузку стилейAJAX_OPTION_STYLE[Y|N] Если параметр принимает значение "Y", то при совершении AJAX-переходов будет происходить подгрузка и обработка списка стилей, вызванных компонентом.
Включить эмуляцию навигации браузераAJAX_OPTION_HISTORY[Y|N] Когда пользователь выполняет AJAX-переходы, то при включенной опции можно использовать кнопки браузера Назад и Вперед.
Дополнительные настройки
URL, ведущий на страницу с содержимым элемента разделаDETAIL_URLУказывается путь к странице с детальным описанием элемента раздела.
Название переменной, в которой передается код группыSECTION_ID_VARIABLEЗадается имя переменной, в которой будет передаваться идентификатор раздела.
Выводить список элементов инфоблокаDISPLAY_ELEMENT_SELECT_BOX[Y|N] При отмеченной опции после таблицы будет добавлен список элементов текущего инфоблока, которые можно добавить в таблицу.
По какому полю сортируем список элементовELEMENT_SORT_FIELD_BOXУказывается поле, по которому будет происходить сортировка элементов:
  • shows – по количеству просмотров в среднем;
  • sort – по индексу сортировки;
  • timestamp_x – по дате изменения;
  • name – по названию;
  • id – по идентификатору;
  • active_from – по дате активности с;
  • active_to – по дате активности по;
  • CATALOG_AVAILABLE – по доступности к покупке.
  • SCALED_PRICE_[ID] – по типу цен (вместо [ID] - идентификатор типа цены)
Порядок сортировки списка элементовELEMENT_SORT_ORDER_BOXЗадается порядок сортировки элементов:
  • ascПо возрастанию;
  • descПо убыванию.
Поле для второй сортировки списка элементовELEMENT_SORT_FIELD_BOX2Указывается поле, по которому будет происходить сортировка элементов:
  • shows – по количеству просмотров в среднем;
  • sort – по индексу сортировки;
  • timestamp_x – по дате изменения;
  • name – по названию;
  • id – по идентификатору;
  • active_from – по дате активности с;
  • active_to – по дате активности по;
  • CATALOG_AVAILABLE – по доступности к покупке.
  • SCALED_PRICE_[ID] – по типу цен (вместо [ID] - идентификатор типа цены)
Порядок второй сортировки списка элементовELEMENT_SORT_ORDER_BOX2Задается порядок сортировки элементов:
  • ascПо возрастанию;
  • descПо убыванию.
Не отображать недоступные товарыHIDE_NOT_AVAILABLE[Y|N] При отмеченной опции будут скрыты товары, для которых общее количество на складах меньше либо равно нулю, включен количественный учет и не разрешена покупка при отсутствии товара.
Настройки действий
Название переменной, в которой передается действиеACTION_VARIABLEУказывается имя переменной, в которой передается действие: ADD_TO_COMPARE_LIST, ADD2BASKET и т.д. Значение поля по умолчанию ACTION. Значение параметра должно быть уникальным среди всех используемых компонентов на одной странице.
Название переменной, в которой передается код товара для покупкиPRODUCT_ID_VARIABLEЗадается имя переменной, в которой будет передаваться идентификатор товара для покупки.
Цены
Тип ценыPRICE_CODEУказывается тип цены для выводимых элементов. Если не задан ни один из типов, то цена товара и кнопки Купить и В корзину показаны не будут.
Использовать вывод цен с диапазонамиUSE_PRICE_COUNT[Y/N] При отмеченной опции будут отображаться цены всех типов на товары.
Выводить цены для количестваSHOW_PRICE_COUNTПараметр определяет количество единиц товара, для которых выводить стоимость.
Включать НДС в ценуPRICE_VAT_INCLUDE[Y|N] При отмеченной опции цены будут показаны с учетом НДС.
Показывать цены в одной валютеCONVERT_CURRENCYПри установке флажка цены будут выводиться в одной валюте, даже если в каталоге они будут заданы в разных валютах; станет доступным дополнительное поле
Валюта, в которую будут сконвертированы ценыCURRENCY_IDВыбор валюты, в которой будут отображаться цены.
. При выборе этой опции кеш компонента будет автоматически сбрасываться при изменении курсов валют тех товаров, что показываются компонентом. К примеру, если выбрана конвертация в рубли, а цены в инфоблоке сохранены в евро, то кеш сбросится при изменении курса евро или рубля. Изменения остальных валют на кеш не окажут влияния.
Добавление в корзину
URL, ведущий на страницу с корзиной покупателяBASKET_URLУказывается путь к странице с корзиной покупателя.


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

<?$APPLICATION->IncludeComponent (
"bitrix:catalog.compare.result",
	"",
	Array(
		"AJAX_MODE" => "Y",
		"NAME" => "CATALOG_COMPARE_LIST",
		"IBLOCK_TYPE" => "news",
		"IBLOCK_ID" => "2",
		"FIELD_CODE" => array(),
		"PROPERTY_CODE" => array(),
		"OFFERS_FIELD_CODE" => array(),
		"OFFERS_PROPERTY_CODE" => array(),
		"ELEMENT_SORT_FIELD" => "sort",
		"ELEMENT_SORT_ORDER" => "asc",
		"DETAIL_URL" => "",
		"BASKET_URL" => "/personal/basket.php",
		"ACTION_VARIABLE" => "action",
		"PRODUCT_ID_VARIABLE" => "id",
		"SECTION_ID_VARIABLE" => "SECTION_ID",
		"PRICE_CODE" => array(),
		"USE_PRICE_COUNT" => "Y",
		"SHOW_PRICE_COUNT" => "1",
		"PRICE_VAT_INCLUDE" => "Y",
		"DISPLAY_ELEMENT_SELECT_BOX" => "Y",
		"ELEMENT_SORT_FIELD_BOX" => "name",
		"ELEMENT_SORT_ORDER_BOX" => "asc",
		"ELEMENT_SORT_FIELD_BOX2" => "id",
		"ELEMENT_SORT_ORDER_BOX2" => "desc",
		"HIDE_NOT_AVAILABLE" => "N",
		"AJAX_OPTION_SHADOW" => "Y",
		"AJAX_OPTION_JUMP" => "Y",
		"AJAX_OPTION_STYLE" => "Y",
		"AJAX_OPTION_HISTORY" => "Y",
		"CONVERT_CURRENCY" => "Y",
		"CURRENCY_ID" => "RUB",
		"TEMPLATE_THEME" => "blue",
	)
);?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024