README

yii2-nav-x      

扩展的 bootstrap Nav 小部件，用于 Yii Framework 2，具有子菜单钻取功能。此小部件扩展了 Bootstrap 3.x 的 \yii\bootstrap\Nav 小部件，Bootstrap 4.x 的 \yii\bootstrap4\Nav 小部件以及 Bootstrap 5.x 的 \yii\bootstrap5\Nav 小部件，并添加了一些额外的控制和 CSS 样式以启用子菜单钻取。下拉菜单样式针对桌面和移动设备进行了优化。钻取是在 active 而不是 hover 上触发的，因此它在移动设备上也能同样良好地工作。默认情况下，此扩展使用以下下拉类扩展之一来渲染下拉导航，但这可以覆盖

• \kartik\dropdown\DropdownX 用于 Bootstrap 3.x
• \kartik\bs4dropdown\Dropdown 用于 Bootstrap 4.x
• \kartik\bs5dropdown\Dropdown 用于 Bootstrap 5.x

演示

您可以在此处找到有关扩展使用方法的详细文档。

安装

根据您应用程序中使用的 Bootstrap 版本安装依赖项

1. 对于 Bootstrap 3.x，安装 kartik-v/yii2-dropdown-x

$ php composer.phar require kartik-v/yii2-dropdown-x "@dev"

1. 对于 Bootstrap 4.x，安装 kartik-v/yii2-bootstrap4-dropdown

$ php composer.phar require kartik-v/yii2-bootstrap4-dropdown "@dev"

1. 对于 Bootstrap 5.x，安装 kartik-v/yii2-bootstrap5-dropdown

$ php composer.phar require kartik-v/yii2-bootstrap5-dropdown "@dev"

安装此扩展的首选方法是使用 composer。

注意：检查此扩展的 composer.json 文件，以了解此扩展的要求和依赖项。请参阅有关设置应用程序 composer.json 的 minimum-stability 设置的网络提示 /wiki。

运行以下命令之一

$ php composer.phar require kartik-v/yii2-nav-x "@dev"

或添加

"kartik-v/yii2-nav-x": "@dev"

到您的 composer.json 文件的 require 部分。

使用方法

NavX

use kartik\nav\NavX;
echo NavX::widget([
    'options' => ['class' => 'nav nav-pills'],
    'items' => [
        ['label' => 'Action', 'url' => '#'],
        ['label' => 'Submenu', 'items' => [
            ['label' => 'Action', 'url' => '#'],
            ['label' => 'Another action', 'url' => '#'],
            ['label' => 'Something else here', 'url' => '#'],
        ]],
        ['label' => 'Something else here', 'url' => '#'],
        '<li class="divider"></li>',
        ['label' => 'Separated link', 'url' => '#'],
    ],
    'encodeLabels' => false
]);

许可证

yii2-nav-x 在 BSD-3-Clause 许可证下发布。有关详细信息，请参阅捆绑的 LICENSE.md 文件。