Документация для разработчиков
Темная тема
Недоступно в редакциях: Стандарт, Старт

Привязка к местоположению: выпадающие списки


Описание sale.location.selector.steps

Компонент выводит форму, в которой выбор местоположения осуществляется с помощью последовательного выбора вариантов из выпадающего списка. Компонент стандартный и входит в дистрибутив модуля.

В визуальном редакторе компонент расположен по пути: Магазин > Процедура оформления заказа > Привязка к местоположению: выпадающие списки.

Компонент относится к модулю Интернет-магазин.

Важно! Компонент используется только при работе с местоположениями версии 2.0.



Параметры

Поле Параметр Описание
Основные параметры
ID местоположения ID Идентификатор местоположения, которое должно быть отображено в форме. Можно не задавать, если задан Символьный код местоположения.
Символьный код местоположения CODE Символьный код местоположения, которое должно быть отображено в форме. Можно не задавать, если задан ID местоположения.
Имя поля ввода INPUT_NAME Задается название переменной для имени поля ввода.
Сохранять связь через PROVIDE_LINK_BY Указывается, что необходимо записать в форму ввода при выборе местоположения: идентификатор (id) или символьный код (code).
Источник данных
Отображать статичный ствол дерева PRESELECT_TREE_TRUNK [Y|N] Если у дерева местоположений есть цепочка, ведущая от корня и не имеющая разветвлений, то при отмеченной опции она будет отображена в селекторе как выбранная изначально.
Предварительно загружать последний выбранный уровень PRECACHE_LAST_LEVEL [Y|N] Если опция включена, то последний выбранный уровень будет пред-загружен при показе компонента. В противном случае, данные будут загружены при попытке открытия выпадающего списка.
Фильтровать по сайту FILTER_BY_SITE [Y|N] При отмеченной опции выбор местоположений осуществляется только среди тех, которые привязаны к сайту.
Отображать местоположения по умолчанию SHOW_DEFAULT_LOCATIONS [Y|N] При отмеченной опции вверху формы выбора местоположений будут отображены избранные местоположения.
Cайт FILTER_SITE_ID Указывается сайт, по местоположениям которого будет делаться выборка.
Настройки кеширования
Тип кеширования CACHE_TYPE Тип кеширования:
  • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
  • Y - Кешировать: для кеширования необходимо определить время кеширования;
  • N - Не кешировать: кеширования нет в любом случае.
Время кеширования (сек.) CACHE_TIME Время кеширования, указанное в секундах.
Дополнительные настройки
Идентификатор javascript-контрола JSCONTROL_GLOBAL_ID Системный параметр. Не описывается.
Javascript-функция обратного вызова JS_CALLBACK Системный параметр. Не описывается.
Не показывать ошибки, если они возникли при загрузке компонента SUPPRESS_ERRORS [Y|N] При отмеченной опции ошибки, возникающие при загрузке компонента, отображаться не будут.
Отключить поиск через ввод с клавиатуры и не показывать следующий уровень при выборе DISABLE_KEYBOARD_INPUT [Y|N] При отмеченной опции будет отключен поиск местоположений через ввод с клавиатуры не будет показываться следующий уровень при выборе.
Инициализировать компонент только при наступлении указанного javascript-события на объекте window.document INITIALIZE_BY_GLOBAL_EVENT Название javascript-события, при наступлении которого будет инициализироваться компонент.


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

<?$APPLICATION->IncludeComponent(
	"bitrix:sale.location.selector.steps",
	"",
	Array(
		"COMPONENT_TEMPLATE" => ".default",
		"ID" => "980",
		"CODE" => "",
		"INPUT_NAME" => "LOCATION",
		"PROVIDE_LINK_BY" => "id",
		"JSCONTROL_GLOBAL_ID" => "",
		"JS_CALLBACK" => "",
		"FILTER_BY_SITE" => "Y",
		"SHOW_DEFAULT_LOCATIONS" => "Y",
		"CACHE_TYPE" => "A",
		"CACHE_TIME" => "36000000",
		"FILTER_SITE_ID" => "s1",
		"PRECACHE_LAST_LEVEL" => "N",
		"PRESELECT_TREE_TRUNK" => "N",
		"DISABLE_KEYBOARD_INPUT" => "N",
		"INITIALIZE_BY_GLOBAL_EVENT" => "",
		"SUPPRESS_ERRORS" => "N"
	)
);?>


© «Битрикс», 2001-2022, «1С-Битрикс», 2022
Наверх