README

AdminLte 侧边栏的 Bootstrap Treeview 生成器，基于 meysampg/yii2-treeview

描述

对 meysampg/yii2-treeview treemenu 进行了简单的增强，原作者合并速度太慢，我 fork 了一个。

它是 yii\bootstrap\Nav 的一个扩展版本，用于为支持徽章的 AdminLte 侧边栏生成适当的代码。

安装

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

运行以下命令之一：

composer require xiongchuan/yii2-adminlte-treeview "*"

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

"xiongchuan/yii2-adminlte-treeview": "*"

使用方法

扩展安装完成后，只需在代码中使用它，如下所示：

use xiongchuan\treeview\Treeview;

然后在代码中使用它：

<!-- sidebar menu: : style can be found in sidebar.less -->
<?= Treeview::widget([
    'items' => [
      [
          'label' => Yii::t('app', 'Dashboard'),
          'icon' => 'fa fa-dashboard',
          'url' => Url::home(),
      ],
      [
          'label' => Yii::t('app', 'Messages'),
          'icon' => 'fa fa-envelope',
          'items' => [
              [
                  'label' => Yii::t('app', 'Inbox'),
                  'url' => ['/message/inbox'],
              ],
              [
                  'label' => Yii::t('app', 'Outbox'),
                  'url' => ['/message/outbox'],
              ],
              [
                  'label' => Yii::t('app', 'Create'),
                  'url' => ['/message/create'],
              ],
          ],
      ],
    ]
]) ?>

输出就是所需的结果

示例

这里是一个 RTL 示例

<!-- sidebar menu: : style can be found in sidebar.less -->
<?= Treeview::widget([
    'items' => [
        [
            'label' => 'داشبورد',
            'icon' => 'fa fa-dashboard',
            'url' => Url::home(),
        ],
        [
            'label' => 'پیام‌ها',
            'icon' => 'fa fa-envelope',
            'items' => [
                [
                    'label' => 'صندوق ورودی',
                    'url' => ['/message/inbox'],
                    'badget' => [
                        'text' => 4,
                        'color' => 'label-info',
                        'float' => 'left',
                    ],
                ],
                [
                    'label' => 'صندوق خروجی',
                    'url' => ['/message/outbox'],
                ],
                [
                    'label' => 'ایجاد پیام',
                    'url' => ['/message/create'],
                ],
            ],
        ],
    ]
]) ?>

和 LTR 示例

<!-- sidebar menu: : style can be found in sidebar.less -->
<?= Treeview::widget([
    'items' => [
        [
            'label' => 'Dashboard',
            'icon' => 'fa fa-dashboard',
            'url' => Url::home(),
        ],
        [
            'label' => 'Message',
            'icon' => 'fa fa-envelope',
            'items' => [
                [
                    'label' => 'Inbox',
                    'url' => ['/message/inbox'],
                    'badget' => [
                        'text' => 4,
                        'color' => 'label-info',
                    ],
                ],
                [
                    'label' => 'Outbox',
                    'url' => ['/message/outbox'],
                ],
                [
                    'label' => 'Create',
                    'url' => ['/message/create'],
                ],
            ],
        ],
    ]
]) ?>

配置

此扩展不需要太多配置。只需将侧边栏项的数组发送到 Treeview 的 items 属性。对于 badget 的 color 属性，它可以是带有颜色的 CSS 类，为了方便，你可以使用以下值：

• label-default
• label-success
• label-info
• label-danger
• label-warning

贡献

报告错误、请求功能或进行修改并发送 pull request :).