成行项目(WEB)
编辑 | blame | 历史 | 原始文档

💝 长期赞助商



🌈 介绍

基于 vue3.x + CompositionAPI setup 语法糖 + typescript + vite + element plus + vue-router-next + pinia 技术，适配手机、平板、pc 的后台开源免费模板，希望减少工作量，帮助大家实现快速开发。

⛱️ 线上预览

💒 代码仓库

🚧 安装 cnpm、yarn

  • 复制代码(桌面 cmd 运行) npm install -g cnpm --registry=https://registry.npm.taobao.org
  • 复制代码(桌面 cmd 运行) npm install -g yarn

🏭 环境支持

Edge Firefox Chrome Safari
Edge ≥ 88 Firefox ≥ 78 Chrome ≥ 87 Safari ≥ 13

由于 Vue3 不再支持 IE11，故而 ElementPlus 也不支持 IE11 及之前版本。

⚡ 使用说明

建议使用 cnpm，因为 yarn 有时会报错。node 版本 > 14.18+/16+

Vite 不再支持 Node 12 / 13 / 15，因为上述版本已经进入了 EOL 阶段。现在你必须使用 Node 14.18+ / 16+ 版本。

# 克隆项目
git clone https://gitee.com/lyt-top/vue-next-admin.git

# 进入项目
cd vue-next-admin

# 安装依赖
cnpm install

# 运行项目
cnpm run dev

# 打包发布
cnpm run build

📚 开发文档

💯 学习交流加 QQ 群

1 - 4 交流群已满，请加 vue-next-admin 交流群 5

群号：556254895

其它交流群请查看文档首页 vueNextAdmin 解疑问

💒 集成后端

❤️ 鸣谢列表

💕 特别感谢

特别感谢老哥们的建议、指导与帮忙。谢谢！

💌 支持作者

如果觉得框架不错，或者已经在使用了，希望你可以去 Github 或者
Gitee 帮我点个 ⭐ Star，这将是对我极大的鼓励与支持。

编辑 | blame | 历史 | 原始文档

vue-next-admin 更新日志

🎉🎉🔥 vue-next-admin 基于 vue3.x 、Typescript、vite、Element plus 等，适配手机、平板、pc 的后台开源免费模板库（vue2.x 请切换 vue-prev-admin 分支）

2.4.31

2023.03.10

2.4.3

2023.02.22

🚩🚩🚩 感谢 驰骋工作流引擎-表单引擎-低代码开发平台 赞助商的赞助。驰骋公司为社会提供流程引擎+表单引擎+低代码开发平台一体的开源软件解决方案，欢迎广大开发者前去体验！

2.4.21

2022.12.12

  • 🌟 更新 依赖更新最新版本
  • 🎉 新增 菜单背景高亮颜色可自定义，通过 布局配置 -> 菜单设置 -> 菜单高亮背景色 进行设置
  • 🐞 修复 分栏布局 二级导航菜单内容多时，无法滚动问题，感谢群友@静雨轩主人
  • 🐞 修复 !42 修复 工作流无法添加新节点问题，感谢@beta
  • 🎯 优化 /make/tableDemo 表头很多时，无法滚动问题，感谢群友@糊涂涂涂

2.4.2

2022.12.09

2.4.1

2022.11.30

2.4.0

2022.11.29

⚡⚡⚡ 此版为破坏性更新，应群友建议 script lang="ts" 改 script lang="ts" setup 语法糖。

  • 🌟 更新 依赖更新最新版本
  • 🎉 新增 表格封装演示，路径：组件封装 -> 表格封装演示
  • 🎉 新增 master 分支 script lang="ts" 改成 script lang="ts" setup 语法糖，将同步基础分支
  • 🐞 修复 v2.3.0 版本报错问题处理
  • 🐞 修复 el-backtop 滚动高度不触发（固定了 header），感谢@dejavuuuuu
  • 🎯 优化 完善 ts 类型，删除根目录 plugins.d.ts、shim.d.ts、source.d.ts，移入到 /src/types/global.d.ts
  • 🎯 优化 代码 watch 移动到 生命周期钩子 最后，文字注释等

2.3.0

2022.11.16

2.2.0

2022.07.10

⚡⚡⚡ /sec/stores/userInfo.ts 下添加了 getApiUserInfo 接口模拟数据 setTimeout 为 3 秒

2.1.1

2022.05.27

2.1.0

2022.04.18

⚡⚡⚡ 此版本为破环性更新，优化内容如下：（谨慎更新！谨慎更新！！谨慎更新！！！）。因为 vuex 替换成 pinia

2.0.2

2022.03.04

  • 🌟 更新 依赖更新最新版本
  • 🎯 优化 Alert 提示添加边框
  • 🎯 优化 功能 / 数字滚动 演示界面
  • 🐞 修复 全局主题按钮颜色 :active 问题
  • 🐞 修复 Dropdown 下拉菜单样式问题
  • 🐞 修复 SvgIcon 图标组件动态切换时报警告问题，SvgIcon 改变 name 时可能导致图像不显示，感谢@axcc1234

2.0.1

2022.02.25

2.0.0

2022.02.21

⚡⚡⚡ 此版本为破环性更新，优化内容如下：（谨慎更新！谨慎更新！！谨慎更新！！！）。演示界面建议直接覆盖文件。如需使用之前版本，请前往gitee 发行版 进行对应版本下载。基础版会基于 master 分支进行修改

  • 🌟 更新 依赖更新最新版本
  • 🌟 更新 登录页、首页
  • 💔 移除 vue-web-screen-shot
  • 💔 移除 城市多级联动，完整 json 数据请去 vue-next-admin-images/menu 仓库查看
  • 💔 移除 功能/echartsTree 树图
  • 💔 移除 其它设置/Tagsview 风格 2、Tagsview 风格 3
  • 💔 移除 功能/验证器
  • 🚧 调整 src/api 编写方式
  • 🚧 调整 自定义封装公用组件演示，更好的维护
  • 🎉 新增 Volar 支持，vs code 配置参考 Vue Language Features (Volar)
  • 🎉 新增 SvgIcon 支持本地 svg 图标使用
  • 🎉 新增 表单表格验证演示
  • 🎯 优化 全局主题（移除 success、info、warning、danger）
  • 🎯 优化 工作流（开源）
  • 🎯 优化 element plus svg 图标，elementXXX 改成 ele-XXX
  • 🌈 重构 深色模式
  • 🌹 合并 处理 parent 的 h100 由于外层有 min-height 导致失效的问题，感谢@MaxNull、@21030442-mao
  • 🐞 修复 element plus 升级 ^1.3.0-beta.5 后 组件 size 大小问题（大改：涉及布局、演示界面）
  • 🐞 修复 vs code 使用 Vue Language Features (Volar) 插件 代码报红问题（可以把公用的 ts 类型定义封装起来公用）

1.2.2

2021.12.21

  • 🌟 更新 依赖更新最新版本
  • 🎯 优化 iframes 滚动条问题
  • 🎯 优化 部署后每次都要强制刷新清浏览器缓存问题
  • 🎉 新增 工具类百分比验证演示
  • 🐞 修复 tag-view 标签右键会超出浏览器 #I4KN78

1.2.1

2021.12.12

  • 🌟 更新 依赖更新最新版本
  • 🎯 优化 cropper 裁剪时卡顿问题 #I4M2VQ
  • 🎯 优化 Wangeditor 富文本编辑器的问题 #I4LPC1、#I4LM7I
  • 🐞 修复 浏览器标题问题
  • 🐞 修复 element plus svg 图标引入
  • 🐞 修复 工作流不可以拖线连接问题

1.2.0

2021.11.28

  • 🌟 更新 依赖更新最新版本
  • 🎯 优化 深色模式
  • 🎯 优化 /@/utils 文件夹，合并删除单一内容
  • 🎯 优化 系统设置：菜单管理（新增、修改）、角色管理（新增菜单权限）、用户管理、部门管理、字典管理
  • 🎯 优化 登录界面逻辑、权限管理逻辑
  • 🎯 优化 同步 vue-next-admin-images 后端控制菜单模拟数据
  • 🎉 新增 适配 Font Icon 向 SVG Icon 迁移（改动大，"element-plus": "^1.2.0-beta.4" 谨慎更新）
  • 🐞 修复 热更新问题，感谢@甜蜜蜜
  • 🐞 修复 页面/element 字体图标演示
  • 🐞 修复 功能/图标选择器演示，新增高级功能 issues #I4GJXQ

1.1.2

2021.10.17

  • 🌟 更新 依赖更新最新版本
  • 🐞 修复 开启全屏时，刷新界面被还原成未全屏的状态
  • 🎯 优化 tagsView 右键菜单关闭逻辑
  • 🎯 优化 wangeditor 富文本编辑器（增加双向绑定）
  • 🎉 新增 工作流（暂不开源）
  • 🎉 新增 基础版 ts（不带国际化），切换 vue-next-admin-template 分支

1.1.1

2021.09.25

  • 🌟 更新 依赖更新最新版本（"element-plus": "^1.1.0-beta.13" 版本运行错误，^1.1.0-beta.16修复横向菜单卡死问题）
  • 🐞 修复 Dialog 弹窗位置错误、Drawer 抽屉内边距、el-menu 菜单收起时背景色问题
  • 🎯 优化 锁屏界面自动锁屏(s/秒)必须设置至少 1 秒
  • 🎉 新增 分栏布局，鼠标移入当前项时，显示当前项菜单内容
  • 🎉 新增 工作流（未完成）

1.1.0

2021.09.10

  • 🌟 更新 依赖更新最新版本
  • 🎯 优化 小屏模式下登录页二维码遮挡标题问题
  • 🎉 新增 图片验证器
  • 🎉 新增 动态复杂表单
  • 🎉 新增 工作流（未完成）
  • 🎉 新增 深色主题(伪深色，样式变动大，谨慎更新)

1.0.18

2021.08.29

  • 🌟 更新 依赖更新最新版本
  • 🎯 优化 权限组件去掉顶级 div（/src/components/auth）
  • 🎉 新增 布局配置添加恢复默认按钮
  • 🐞 修复 升级 element plus 1.1.0-beta.7后项目无法启动、el-menu 菜单
  • 🐞 修复 表格固定列时的层级、设置了相对定位时，遮挡左侧导航菜单问题

1.0.17

2021.08.22

  • 🌟 更新 依赖更新最新版本
  • 🎯 优化 去除设置布局切换，重置主题样式（initSetLayoutChange），切换布局需手动设置样式，设置的样式自动同步各布局
  • 🎯 优化 Dropdown 下拉菜单用户账号靠边时换行问题
  • 🎯 优化 左侧导航菜单，共用菜单树，防止 布局配置 设置 菜单 / 顶栏 时，样式丢失等问题
  • 🐞 修复 固定 header 后没有回到顶部的 bug，拉取项目后运行不起来的 bug。!14，感谢@wjs0509
  • 🐞 修复 tagView 右键全屏后，浏览器窗口大小发生任何变化都会导致左边菜单显示出来，并且可点击打开对应页面。I46E6T
  • 🐞 修复 默认设置 菜单 / 顶栏 样式不生效问题（/@/src/store/modules/themeConfig.ts）

1.0.16

2021.08.14

  • 🌟 更新 依赖更新最新版本
  • 🎯 优化 菜单高亮（详情且详情设置了 meta.isHide 时，顶级菜单高亮），感谢群友@YourObject
  • 🎯 优化 详情路径写法：如父级（/pages/filtering），那么详情为（/pages/filtering/details?id=1）。这样写可实现（详情时，父级菜单高亮），否则写成（/pages/filteringDetails?id=1）顶级菜单将不会高亮。可参考：页面/过滤筛选组件，点击当前图片进行测试
  • 🎯 优化 tagsView 右键菜单全屏时，打开的界面高度问题
  • 🎯 优化 图表批量 resize 问题
  • 🐞 修复 菜单收起时（设置全局主题：primary 且有二级菜单时），文字高亮颜色不对
  • 🐞 修复 国际化 #I43NPE。可参考：页面/过滤筛选组件，点击顶部语言切换，进行底部分页国际化查看

1.0.15

2021.08.06

  • 🌟 更新 依赖更新最新版本
  • 🎯 优化 tagsView 右键菜单点击时的字段名（id 已修改成 contextMenuClickId）与路由中返回的 id 名冲突问题，感谢群友@伯牙已遇钟子期
  • 🎉 新增 多个 form 表单验证界面演示

1.0.14

2021.07.29

  • 🌟 更新 依赖更新最新版本（vue、vuex、vue-router）,出现问题，请手动降级。版本查看：vnpm
  • 🎯 优化 数据可视化图表演示加载卡顿问题、优化有图表的演示界面
  • 🎯 优化 路由参数演示界面
  • 🎯 优化 tagsView 操作演示界面，由于存在相同路由多标签，必须要传全部参数值（query 或者 params）
  • 🎉 新增 开启 TagsView 共用，开启时：（多个路由菜单共用一个详情组件（参数为后点击的覆盖前面点击的），tagsView 中只会出现一个（不支持同时出现多个 tagsView 标签））。关闭时：（多个路由菜单共用一个详情组件，参数不同，会同时出现多个 tagsView 标签）
  • 🐞 修复 tagsView 共用（单标签）时，右键菜单功能点击，参数不对的问题（第 2n+个参数未覆盖第一个参数值）
  • 🐞 修复 多 tagsView 标签（参数不同）、单个 tagsView 标签公用（参数不同）所带来的刷新功能、横向自动滚动等问题
  • 🐞 修复 处理全屏若干问题，pr!12，感谢群友@另一个前端

1.0.13

2021.07.25

  • 🌟 更新 依赖更新最新版本
  • 🎉 新增 数据可视化演示界面（/visualizingDemo1、/visualizingDemo2）
  • 🎉 新增 登录页扫码登录

1.0.12

2021.07.16

  • 🌟 更新 依赖更新最新版本
  • 🎉 新增 数据可视化演示空界面（待完善）
  • 🎯 优化 tagsView 动态路由（xxx/:id/:name）时的右键菜单刷新、关闭其它时参数丢失问题（2021.07.15 优化）
  • 🐞 修复 路由带参数时，复制路径到登录页，跳转后参数消失的问题
  • 🐞 修复 设置多个外链，点击后，页面内容停留在上一个内容（内容未改变）、国际化处理、打开新窗口 sessionStorage 共享等

1.0.11

2021.07.14

  • 🌟 更新 依赖更新最新版本
  • 🎉 新增 路由参数、图片懒加载界面演示
  • ⚠️ 警告 Form 表单 binding value must be a string or number，解决：加上 label-position="top" 不报警告（等待官方修复）
  • 🎯 优化 锁屏界面动画效果、首页图表显示
  • 🎯 优化 tagsView 右键菜单 关闭 功能逻辑
  • 🐞 修复 开启 TagsView 拖拽报错及小于 1000px 时自动设置禁止拖拽（#I3ZRRI）
  • 🐞 修复 iframe 内嵌、外链 高度问题，使用 computed 进行计算
  • 🐞 修复 默认布局开启 侧边栏 Logo 与关闭 菜单水平折叠，切换到横向布局时，菜单看不见的问题
  • 🐞 修复 切换不同布局时，再去开启 经典布局分割菜单 功能不生效问题
  • 🐞 修复 浏览器窗口标题中/英文切换不实时生效的问题
  • 🐞 修复 切换布局时，某些功能不可以使用。部分界面不需要取消事件监听(proxy.mittBus.off('xxx'))
  • 🐞 修复 动态路由带参数，router-link 跳转问题（#I3YX6G）
  • 🐞 修复 横向菜单有二级菜单时，点击子级菜单不高亮问题
  • 🐞 修复 功能 tagsView 操作演示不生效

1.0.10

2021.07.07

  • 🌟 更新 依赖更新最新版本（字体图标无问题）
  • 🎯 优化 内嵌 iframe、外链，解决 tagsView 刷新问题

1.0.9

2021.07.02

  • 🌟 更新 依赖更新最新版本
  • 🎯 优化 图标选择器设置宽度、v-model 等问题
  • 🎯 优化 滚动通知栏在手机上的体验
  • 🎯 优化 系统管理/新增菜单（编辑菜单），使用 图标选择器 进行模拟
  • 🎯 优化 字体图标(自动载入) 逻辑
  • 🐞 修复 screenfull 全屏时，按键盘 esc 键图标不改变问题，感谢群友@伯牙已遇钟子期

1.0.8

2021.06.29

  • 🌟 更新 依赖更新最新版本
  • 🎉 新增 表单中英文切换演示
  • 🎯 优化 登录页查看密码 icon 图标
  • 🎯 优化 图标选择器
  • 🎯 优化 拖动指令
  • 🐞 修复 form 表单在页面小于 576px 时的排版问题

1.0.7

2021.06.24

  • 🌟 更新 依赖更新最新版本
  • 🎉 新增 拖动指令及其演示界面
  • 🎯 优化 锁屏界面，解锁提示
  • 🎯 优化 登录页在手机上显示的效果

1.0.6

2021.06.23

  • 🎯 优化 去掉内嵌 iframe 内边距（padding）
  • 🎯 优化 城市多级联动组件
  • 🎯 优化 Tree 树形控件改成表格组件
  • 🐞 修复 Cascader 级联选择器高度问题

1.0.5

2021.06.22

  • 🌟 更新 vite 降级为@vite2.3.7，降级方法 cnpm install vite@2.3.7，防止 element plus 字体图标消失
  • 🐞 修复 开启后端控制路由（isRequestRoutes = true）时，内嵌 iframe、外链不可使用的问题

1.0.4

2021.06.19

  • 🌟 更新 依赖更新最新版本（"vite": "^2.3.7"）热更新无问题
  • 🎉 新增 深克隆工具，方便开发，感谢@kangert(#6)
  • 🎯 优化 vuex 模块自动导入。感谢@kangert(#4)，感谢群友@web 小学生-第五君
  • 🎯 优化 类型定义提高编码体验，修复不能将类型“string | undefined”分配给类型“string”的问题。感谢@kangert(#5)
  • 🎯 优化 layout 文件夹移动到与 views 文件夹同级（改动较大，/@/views/layout 变成 /@/layout）
  • 🎯 优化 页面有 console.log 时 eslint 不生效问题
  • 🎯 优化 页面、ts 中 any 类型问题（改动较大）
  • 🎯 优化 登录页在手机上显示的效果
  • 🎯 优化 多行注释信息，鼠标放到方法名即可查看，更加直观的知道方法参数等。引入方法时需去掉以 .ts 结尾的后缀（改动较大）
  • 🎯 优化 移除 utils/storage.ts 下的旧写法（改动较大）
  • 🎯 优化 拆分 router 下内容，路由、前端、后端控制分开写，方便理解
  • 🐞 修复 鼠标移入顶部用户信息栏 开/关全屏 文字反向问题
  • 🐞 修复 热更新时，NextLoading（界面 loading） 不消失问题 window.nextLoading === undefined
  • 🐞 修复 vuex 中不可以使用 /@/api/xxx 下的接口调用问题

1.0.3

2021.06.02

  • ❄️ 删除 G6 思维导图界面
  • 🌟 更新 手动更新 vue、vue-router、vuex 到最近最多人使用的版本，出现不可预测的问题请降低版本。版本查看：vue 版本查看
  • 🐞 修复 开启后端控制路由 isRequestRoutes 在非首页刷新页面后，回到首页的问题，感谢群友@伯牙已遇钟子期

1.0.2

2021.06.01

  • 🌟 更新 依赖更新最新版本
  • 🐞 修复 菜单搜索中文不可以搜索的问题，感谢群友@逍遥天意

1.0.1

2021.05.31

  • 🎉 新增 更新日志文件 CHANGELOG.md，以后每次更新都会在这里显示对应内容
  • 🌟 更新 依赖更新最新版本
  • 🐞 修复 分栏、经典布局路由设置 meta.isHide 为 true 时报错问题，感谢群友@29、@芭芭拉
  • 🐞 修复 经典布局点击 tagsView 左侧菜单数据不变问题
编辑 | blame | 历史 | 原始文档 
MIT License

Copyright (c) 2021 lyt-Top

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
CHANGELOG 31 KB 查看 | 编辑 | 原始文档 | blame | 历史
README 7 KB 查看 | 编辑 | 原始文档 | blame | 历史