README

构建菜单、移动菜单等各种工具。

安装

安装此扩展的首选方式是通过composer。

运行以下命令之一：

composer require andrewdanilov/yii2-menu "~2.0.0"

或将以下内容添加到您的composer.json文件的require部分：

"andrewdanilov/yii2-menu": "~2.0.0"

变更

2.0.0版本中移除了面包屑小部件，并成为独立的扩展yii2-breadcrumbs

使用方法

如果您想使用自己的菜单模板，请将yii2-menu/src/views文件夹的内容复制到您的指定位置，例如到frontend/views/site/_blocks/，并填写属性templateWrapper、templateParentItem、templateItem、templateActiveItem和templateButton到您的路径值（请参阅以下示例）。

菜单

<?= andrewdanilov\menu\Menu::widget([
    'templateWrapper' => '@frontend/views/site/_blocks/menu/wrapper',
    'templateParentItem' => '@frontend/views/site/_blocks/menu/parent-item',
    'templateItem' => '@frontend/views/site/_blocks/menu/item',
    'templateActiveItem' => '@frontend/views/site/_blocks/menu/active-item',
    'wrapperId' => 'my_menu', // optional, default is 'menu'
    'items' => [
        [
            'label' => 'Menu item 1', // required
            'items' => [ // optional
                [
                    'label' => 'Menu subitem 1', // required
                    'url' => ['site/action1'], // required for single menu items
                    'target' => '_blank', // optional
                ],
                ['label' => 'Menu subitem 2', 'url' => ['site/action2']],
            ],
        ],
        [
            'label' => 'Menu item 2',
            'url' => ['site/action3'], // optional for items has submenu
            'items' => [
                ['label' => 'Menu subitem 3', 'url' => ['site/action4']],
                ['label' => 'Menu subitem 4', 'url' => ['site/action5']],
            ],
        ],
        [
            'label' => 'Menu item 3',
            'url' => ['site/action6'],
            'target' => '_blank',
        ],
    ],
]) ?>

移动菜单

<?= andrewdanilov\menu\MobileMenu::widget([
    'templateWrapper' => '@frontend/views/site/_blocks/mobile-menu/wrapper',
    'templateParentItem' => '@frontend/views/site/_blocks/mobile-menu/parent-item',
    'templateItem' => '@frontend/views/site/_blocks/mobile-menu/item',
    'templateActiveItem' => '@frontend/views/site/_blocks/mobile-menu/active-item',
    'templateButton' => '@frontend/views/site/_blocks/mobile-menu/button',
    'buttonLabel' => 'Menu', // optional, default is ''
    'wrapperId' => 'my_mobile_menu', // optional, default is 'mobile_menu'
    'showNavbar' => true, // optional, default is false
    'items' => [
        [
            'label' => 'Menu item 1',
            'items' => [
                ['label' => 'Menu subitem 1', 'url' => ['site/action1'], 'target' => '_blank'],
                ['label' => 'Menu subitem 2', 'url' => ['site/action2']],
            ],
        ],
        [
            'label' => 'Menu item 2',
            'items' => [
                ['label' => 'Menu subitem 3', 'url' => ['site/action3']],
                ['label' => 'Menu subitem 4', 'url' => ['site/action4']],
            ],
        ],
        ['label' => 'Menu item 3', 'url' => ['site/action3'], 'target' => '_blank'],
        ['label' => 'Menu item 4', 'url' => ['site/action4']],
    ],
]) ?>