Описание 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"
)
);?>