要用layuiAdmin插件重构ThinkPHP后台菜单,需三步:替换静态资源与模板结构、配置JSON接口及字段、动态注入图标与主题色,并启用折叠动画与路由级高亮联动。

要让ThinkPHP后台菜单看起来更专业、更符合现代UI规范,不能只靠CSS微调,得结合插件能力重构渲染逻辑和视觉层级。直接改模板样式容易被权限逻辑覆盖,也难统一控制折叠/高亮/图标状态。
用layuiAdmin插件替换原生菜单结构
第一步:下载 layuiAdmin 前端框架包,解压后将 dist 目录下 css、js、images 三个文件夹整体复制到 public/static/admin/ 目录下。
第二步:在后台入口模板(如 application/view/index/index.html)中,删掉原有 menu 渲染区块,替换为:<div id="admin-side-menu"></div>。
第三步:在该模板底部引入 layuiAdmin 初始化脚本,关键代码如下:
layui.use(['admin', 'element'], function(){
var $ = layui.jquery, admin = layui.admin, element = layui.element;
admin.render({
elem: '#admin-side-menu',
url: '{:url("menu/getList")}',
type: 'get'
});
});
立即学习“PHP免费学习笔记(深入)”;
【必须确保控制器 menu/getList 返回标准 JSON 树形结构,且每个节点含 title、href、icon、spread 字段】字段缺失会导致菜单项不显示或图标错位。
菜单图标与颜色按权限动态加载
方法一:在菜单数据生成阶段注入 icon 映射规则
在 getMenuList() 服务方法中,对每个菜单项追加 icon 字段:
if (strpos($item['permission_code'], 'user:') === 0) { $item['icon'] = 'fa-user'; }
elseif (strpos($item['permission_code'], 'order:') === 0) { $item['icon'] = 'fa-shopping-cart'; }
else { $item['icon'] = 'fa-file-o'; }
方法二:前端用 CSS 变量控制主题色
在 public/static/admin/css/admin.css 中添加:
:root { --menu-active-bg: #1890ff; --menu-hover-bg: #f0f2f5; }
然后在 layuiAdmin 的 menu-item 样式里用 var(--menu-active-bg) 替代硬编码色值。
注意:不要在模板里用 {if $vo.permission_code == 'admin:user:list'} 写一堆 class 判断——这会让 HTML 膨胀且无法复用。
二级菜单折叠动画+点击高亮联动
第一步:确认 layuiAdmin 版本 ≥ v2.7.0,旧版本不支持 smooth 展开动画。
第二步:在初始化代码中启用动画配置:
admin.render({
elem: '#admin-side-menu',
url: '{:url("menu/getList")}',
anim: 'slide', // 启用滑动展开
accordion: true // 同级菜单手风琴效果
});
第三步:高亮逻辑必须绑定到路由名而非 URL 路径——在控制器返回菜单数据前,先获取当前路由名:
$currentRoute = request()->rule()->getName();
遍历菜单树时,对每个节点执行:
if (str_starts_with($currentRoute, $menu['url'])) { $menu['this'] = true; break; }
第四步:在 layuiAdmin 模板中,用 this: 'layui-this' 绑定 class,不要用 JS 手动 addClass——插件内部已封装高亮同步机制。



















