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

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


Описание 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-2024, «1С-Битрикс», 2024
Наверх