Меню
Компонент выводит меню указанного типа. Компонент является стандартным и входит в дистрибутив модуля.
Описание menu
В визуальном редакторе компонент расположен по пути: Служебные > Навигация > Меню.
Компонент относится к Главному модулю.
В поставку продукта входят следующие шаблоны компонента Меню (bitrix:menu):
- Горизонтальное многоуровневое выпадающее меню (Яркий) (horizontal_multilevel);
- Левое меню (Яркий) (left);
- Вертикальное меню по умолчанию (Встроенный шаблон) (.default);
- Голубое меню в виде закладок (Встроенный шаблон) (blue_tabs);
- Серое меню в виде закладок (Встроенный шаблон) (grey_tabs);
- Древовидное меню (Встроенный шаблон) (tree);
- Вертикальное многоуровневое выпадающее меню (Встроенный шаблон) (vertical_multilevel).
Параметры
| Поле | Параметр | Описание |
| Основные параметры | ||
|---|---|---|
| Тип меню для первого уровня | ROOT_MENU_TYPE | Указывается тип меню верхнего уровня, соответствующий данному меню. |
| Настройки кеширования | ||
| Тип кеширования | MENU_CACHE_TYPE | Тип кеширования:
|
| Время кеширования | MENU_CACHE_TIME | Время кеширования в секундах. |
| Учитывать права доступа | MENU_CACHE_USE_GROUPS | При кешировании будут учитываться права доступа пользователя к тем или иным пунктам меню. Если меню построено без учета прав доступа, флажок лучше снять - размер кеша уменьшится. |
| Значимые переменные запроса | MENU_CACHE_GET_VARS | Если отображение меню зависит от параметров страницы, то при использовании кеширования необходимо указать параметры в этом поле. Параметры вводятся через запятую. |
| Дополнительные настройки | ||
| Уровень вложенности меню | MAX_LEVEL | В выпадающем списке выберите уровень вложенности. Доступно четыре уровня. Чем больше число, тем пункты более низких уровней будут отображены. |
| Тип меню для остальных уровней | CHILD_MENU_TYPE | Укажите тип меню для меню нижних уровней. |
| Подключать файлы с именами вида .тип_меню.menu_ext.php | USE_EXT | [Y|N] При отмеченной опции будет разрешено подключать файлы с именами вида .тип_меню.menu_ext.php. |
| Откладывать выполнение шаблона меню | DELAY | [Y|N] При отмеченной опции выполнение шаблона будет происходить после загрузки страницы. Очень удобен при включенном кешировании компонента, если нужно все же выполнять какие-то действия по модификации внешнего вида пунктов меню в зависимости от текущей страницы. Например, добавление пунктов меню в компонентах.
$GLOBALS['BX_MENU_CUSTOM']->AddItem('left', array(
'TEXT' => 'Моб. версия', 'LINK' => $APPLICATION->
GetCurPage(false) . '?mobile'))
Первый параметр - тип меню. Второй - массив, описывающий пункт меню. |
| Разрешить несколько активных пунктов одновременно | ALLOW_MULTI_SELECT | [Y|N] При отмеченной опции будет разрешено несколько активных пунктов меню одновременно. |
| Параметры для ручной настройки, в форме настройки компонента не видны | ||
| CACHE_SELECTED_ITEMS | Y\N. Определяет подмешивать или нет URL в кеш. По умолчанию С версии 23.300.0. - N. Если параметр имеет значение Y, то меню кешируется отдельно для каждого раздела. Если на сайте много разделов, то размер кеша меню может вызвать падение сайта из-за переполнения места на диске. Ограничение константы отключающей подмешивание URL в том, что во вложенном разделе может полностью быть переопределены пункты меню. | |
| MENU_CACHE_USE_USERS | Y\N. Определяет подмешивать ли в кеш id пользователя.То есть делать ли его уникальным для каждого пользователя. Нужно когда оно отличается для каждого пользователя. | |
Пример вызова
<?$APPLICATION->IncludeComponent("bitrix:menu",".default",Array(
"ROOT_MENU_TYPE" => "top",
"MAX_LEVEL" => "1",
"CHILD_MENU_TYPE" => "top",
"USE_EXT" => "Y",
"DELAY" => "N",
"ALLOW_MULTI_SELECT" => "Y",
"MENU_CACHE_TYPE" => "N",
"MENU_CACHE_TIME" => "3600",
"MENU_CACHE_USE_GROUPS" => "Y",
"MENU_CACHE_GET_VARS" => ""
)
);?>
© «Битрикс», 2001-2024, «1С-Битрикс», 2024