Описание 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"
)
);?>
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.