cmxperts / laravel-menu
该包的最新版本(v1.02)没有提供许可证信息。
Laravel 10 的拖拽式菜单生成器
v1.02
2023-08-08 08:51 UTC
Requires
- php: ^8.0
- illuminate/support: ^10.0
README
Laravel 10 的拖拽式菜单生成器
安装
- 运行
composer require cmxperts/laravel-menu
如果你使用laravel 5.5,步骤2和3是可选的
- 在文件 config/app.php 中的 "providers" 数组中添加以下类(在laravel 5.5中为可选)
CmXperts\Menu\Providers\MenuServiceProvider::class,
- 在文件 config/app.php 中添加 facade(在laravel 5.5中为可选)
'Menu' => CmXperts\Menu\Facades\Menu::class,
- 运行 publish
php artisan vendor:publish --provider="CmXperts\Menu\Providers\MenuServiceProvider"
- 在 config/menu.php 中配置(可选)
- 自定义中间件: 你可以添加自己的中间件
- 表前缀: 默认情况下,此包将创建2个新表 "menus" 和 "menu_items",但你仍然可以添加自己的表前缀,以避免与现有表冲突
- 表名: 如果你想要使用特定的表名,你必须修改这些以及迁移文件
- 自定义路由: 如果你想编辑路由路径,你可以编辑该字段
- 角色访问: 如果你想在菜单项上启用角色(权限)
- 运行迁移
php artisan migrate
完成
菜单构建器使用示例 - 显示构建器
在你的视图 blade 文件中
@extends('app') @section('contents') {!! Menu::render() !!} @endsection //YOU MUST HAVE JQUERY LOADED BEFORE menu scripts @push('scripts') {!! Menu::scripts() !!} @endpush
使用模型
调用模型类
use CmXperts\Menu\Models\Menu; use CmXperts\Menu\Models\MenuItem;
菜单使用示例(a)
一个基本的二级菜单可以在你的 blade 模板中显示
使用模型类
/* get menu by id*/ $menu = Menu::find(1); /* or by name */ $menu = Menu::where('name','Test Menu')->first(); /* or get menu by name and the items with EAGER LOADING (RECOMENDED for better performance and less query call)*/ $menu = Menu::where('name','Test Menu')->with('items')->first(); /*or by id */ $menu = Menu::where('id', 1)->with('items')->first(); //you can access by model result $public_menu = $menu->items; //or you can convert it to array $public_menu = $menu->items->toArray();
或使用辅助函数
// Using Helper $public_menu = Menu::getByName('Public'); //return array
菜单使用示例(b)
现在在你的 blade 模板文件中,使用这个简单的示例放置菜单
<div class="nav-wrap"> <div class="btn-menu"> <span></span> </div><!-- //mobile menu button --> <nav id="mainnav" class="mainnav"> @if($public_menu) <ul class="menu"> @foreach($public_menu as $menu) <li class=""> <a href="{{ $menu['link'] }}" title="">{{ $menu['label'] }}</a> @if( $menu['child'] ) <ul class="sub-menu"> @foreach( $menu['child'] as $child ) <li class=""><a href="{{ $child['link'] }}" title="">{{ $child['label'] }}</a></li> @endforeach </ul><!-- /.sub-menu --> @endif </li> @endforeach @endif </ul><!-- /.menu --> </nav><!-- /#mainnav --> </div><!-- /.nav-wrap -->
辅助函数
通过菜单 ID 获取菜单项
use CmXperts\Menu\Facades\Menu; ... /* Parameter: Menu ID Return: Array */ $menuList = Menu::get(1);
通过菜单名称获取菜单项
在此示例中,你必须有一个名为 Admin 的菜单
use CmXperts\Menu\Facades\Menu; ... /* Parameter: Menu ID Return: Array */ $menuList = Menu::getByName('Admin');
自定义
你可以在 resources/views/vendor/cmxperts-menu/menu-html.blade.php 中编辑菜单界面