nurmanhabib/navigator

使用 NavCollection 生成导航或菜单

v5.2.0 2021-05-01 11:41 UTC

README

现在可以用于所有PHP框架,甚至原生PHP。对于Laravel的使用方式变更为 nurmanhabib/laravel-menu

安装

使用Composer安装

非常简单,运行以下命令以获取最新版本。

composer require nurmanhabib/navigator

使用方法

只需创建一个 对象 Nurmanhabib\Navigator\NavCollection,并添加一些 Nurmanhabib\Navigator\NavItem

use Nurmanhabib\Navigator\NavCollection;
use Nurmanhabib\Navigator\Navigator;

$menu = new NavCollection;
$menu->addHome();
$menu->addLink('Berita', '/berita')->match('berita*');
$menu->addSeparator();
$menu->addParent('Kategori', function (NavCollection $menu) {
    $menu->addLink('Teknologi', '/kategori/teknologi');
    $menu->addLink('Otomotif', '/kategori/otomotif');
    $menu->addParent('Lifestyle', function (NavCollection $menu) {
        $menu->addLink('Pria', '/lifestyle-pria');
        $menu->addLink('Wanita', '/lifestyle-wanita');
    });
});

$menu->addHeading('Configuration');
$menu->addLink('Application', '/config/app');

$menu->addHeading('Account');
$menu->addLink('My Profile', '/profile');
$menu->addLink('Logout', '/logout');

$navigator = new Navigator($menu);

echo $navigator->render();

您也可以使用数组数据创建

$data = [
    [
        'text' => 'Home',
        'url' => '/'
    ],
    [
        'text' => 'Berita',
        'url' => 'berita',
        'match' => '/berita*'
    ],
    [
        'type' => 'separator'
    ],
    [
        'text' => 'Kategori',
        'child' => [
            [
                'text' => 'Teknologi',
                'url' => 'kategori/teknologi'
            ],
            [
                'text' => 'Otomotif',
                'url' => 'kategori/otomotif'
            ],
            [
                'text' => 'Lifestyle',
                'child' => [
                    [
                        'text' => 'Pria',
                        'url' => 'lifestyle-pria'
                    ],
                    [
                        'text' => 'Wanita',
                        'url' => 'lifestyle-wanita'
                    ],
                ]
            ],
        ]
    ],
    [
        'type' => 'heading',
        'text' => 'Configuration'
    ],
    [
        'text' => 'Account',
        'child' => [
            [
                'text' => 'Change Password',
                'url' => 'change-password'
            ],
            [
                'text' => 'Logout',
                'url' => 'logout'
            ],
        ]
    ],
];

$factory = new ArrayNavCollectionFactory($data);

$menu = $factory->createNavCollection();

$navigator = new Navigator($menu);

echo $navigator->render();

API

  1. 匹配

    $menu->addLink('Teknologi', 'kategori/teknologi')->match('kategori/*');

    以下路径uri的项将处于活动状态

    • 分类/技术
    • 分类/汽车
  2. setData

    $menu->addLink('Teknologi', 'kategori/teknologi')->setData(['key' => 'value']);

    您可以在菜单项中添加数据,用于自定义渲染时使用。

  3. hasData

    $item->hasData('key');
  4. getData

    echo $item->getData('key');
  5. getType

    echo $item->getType();

    当前支持的类型

    • 链接
    • 主页
    • 标题
    • 分隔符