讲师中心 微信公众号
AI工具推荐 视频效率加速

Layui如何实现左侧导航菜单动态渲染

阿枫姑娘_3822

阿枫姑娘_3822

发布时间:2026-05-03 08:12:16

|

211人浏览过

|

来源于php中文网

原创

layui.navbar() 原生仅支持两级菜单,三级需修改 render() 方法实现递归渲染;路径404需用绝对路径或接口获取数据;刷新丢失选中态需手动匹配 URL 并添加 layui-nav-itemed 类;空菜单须前端校验并提示。

layui.navbar() 不支持三级菜单?得自己改源码

原生 layui.navbar() 只处理两级结构(一级 <li> + 二级 <dl class="layui-nav-child">),遇到三级菜单(比如「账号管理 → 普通账号 → 密码策略」)会直接忽略第三层。你看到菜单展开后子项消失,大概率是这个原因。

解决办法不是换框架,而是补全渲染逻辑:在 navbar 组件的 render() 方法里,遍历数据时判断 field.children 是否存在且为数组,若存在,就对每个子项递归生成 <dd> 内嵌 <dl class="layui-nav-child"> —— 注意层级 class 必须严格匹配 layui 的 CSS 规则,否则 layui-nav-itemed 展开态不生效。

  • 不要用 layui-tree 替代,它和 layui-nav 样式体系不兼容
  • 修改前先备份原始 navbar.js,Layui 2.8.x 的 navbar 源码在 lay/modules/navbar.js
  • 渲染时确保后端返回的数据结构含明确的 pid 和 children 字段,不能只靠 id/pid 手动拼树

动态加载 JSON 数据时路径 404 或 CORS 报错

navbar.set({ url: "../layui/nav2.json" }) 中的 url 是相对路径,由浏览器发起请求,不是服务端解析。如果页面 URL 是 /admin/user/list,那实际请求地址就是 /admin/user/../layui/nav2.json → /admin/lauyi/nav2.json,极大概率 404。

更稳妥的做法是:后端统一提供接口(如 /api/menu),前端用 layui.jquery.get() 先取数据,再传给 navbar.set({ data: menuData });或者把路径写成绝对路径 /static/menu.json。

  • 开发环境用 Nginx 或 webpack-dev-server 配置静态资源别名,避免路径跳转混乱
  • 若用 Spring Boot,nav2.json 放在 src/main/resources/static/ 下才可通过 HTTP 直接访问
  • CORS 错误只在跨域时出现,本地文件协议(file://)下也会触发,必须起服务

菜单选中状态刷新后丢失

Layui 自身不记录当前激活项,layui-this 类只靠 JS 运行时添加。页面一刷新,所有样式重置,左侧菜单就“忘记”哪一项该高亮。

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载

通用解法是读取当前 URL 路径(去掉 query 参数),逐个比对菜单项的 href 属性,手动加类。但要注意:三级菜单的 href 可能出现在 <dd> 里,而展开父级需要同时给 <dt> 或上级 <li> 加 layui-nav-itemed。

  • 别用 window.location.pathname,它带开头的 /,而菜单 href 常为 user/list,直接比对会失败
  • 用 url.substring(url.lastIndexOf("/") + 1).split("?")[0] 提取纯文件名最稳
  • jQuery 选择器要写全:找三级项需用 $('dd a[href="..."]'),再向上找两级 .parent().parent().addClass("layui-nav-itemed")

权限过滤后菜单为空,但容器仍显示

后端返回空数组或过滤后无数据时,navbar.render() 仍会执行,但 <ul id="nav"> 里什么也不生成,导致左侧一片空白,连边框都不见 —— 用户以为页面卡了。

应在调用 render() 前加一层校验:if (!Array.isArray(menuData) || menuData.length === 0) { $('#nav').html('<li class="layui-nav-item"><a href="https://www.php.cn/link/8fcd9e5482a62a5fa130468f4cf641ef">暂无权限</a></li>'); return; }。更进一步,可结合 layer.msg('无访问权限', {icon: 5}); 提示用户。

  • 后端返回的菜单数据必须是数组,哪怕空数组 [],不能是 null 或 { code: 0, data: null }
  • 不要依赖 CSS 的 :empty 伪类做兜底,Layui 渲染过程会插入文本节点,:empty 判定不准
  • 若使用 layuimini,它的 init 方法内部已处理空数据,但需确认版本 ≥ v2.5.0
真实项目里最难缠的不是渲染逻辑,而是菜单数据结构和前端约定不一致:后端返回的字段名可能是 menuList、routes 或 permissionTree,层级键名可能是 subMenu、children、nodes —— 这些细节不统一对齐,光改 JS 无用。

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2463

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

5323

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6370

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

5958

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

843

2024.05.22

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

0

2026.10.15

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

0

2026.10.15

Vue.js 中 ref 和 reactive 的区别
Vue.js 中 ref 和 reactive 的区别

Vue.js中ref和reactive的区别专题汇集两种响应式API的定义、访问方式、对象解构、侦听与性能取舍等文章,帮助结合实际状态类型选择合适写法。

0

2026.10.15

VS Code 怎么配置开发环境
VS Code 怎么配置开发环境

VS Code开发环境专题汇集编辑器安装、语言扩展、编译器、解释器、终端和调试配置文章,覆盖Java、Python、C++和PHP等常见语言的入门设置。

0

2026.10.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 12.9万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 11.1万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn