更新日志

只记录 feat/fix 以及破坏性变更。

v4.12.1

基础版

🐞 Bug Fixes

修复文件系统路由模式下主导航高亮效果不更新 - by @hooray (d40c4)
修复退出登录后Tab页不清除的问题 - by @ResJI and @hooray in https://github.com/fantastic-admin/basic/issues/46 (88900)

专业版

🐞 Bug Fixes

修复文件系统路由模式下主导航高亮效果不更新 - by @hooray (7a031)
修复双击标签页可关闭固定或常驻标签的问题 - by @hooray (9a836)
修复导航顶部面板模式切换路由时会自动显示bug - by @hooray (68aa3)

v4.12.0

基础版

🚨 Breaking Changes

重构鉴权指令、鉴权组件 - by @hooray (c34c2)

🐞 Bug Fixes

修复顶部相关布局时，工具栏重复渲染 - by @hooray (026df)
修复顶部相关布局时，移动端下工具栏不显示 - by @hooray (efd85)
修复vscode无法校验css文件 - by @hooray (5fcfc)

🏎 Performance

优化导航菜单折叠 - by @hooray (15983)

专业版

🚨 Breaking Changes

使用 watermark-js-plus 重构水印功能 - by @hooray (3cce7)
重构鉴权指令、鉴权组件 - by @hooray (f70e5)

🚀 Features

Dayjs 国际化跟随框架设置 - by @hooray (8226c)

🐞 Bug Fixes

修复应用配置里工具栏关闭的功能依旧会在在偏好设置里显示的bug - by @hooray (00089)
修复顶部相关布局时，工具栏重复渲染 - by @hooray (d0ad1)
修复顶部相关布局时，移动端下工具栏不显示 - by @hooray (d7107)
修复vscode无法校验css文件 - by @hooray (e2d64)

🏎 Performance

优化导航菜单折叠 - by @hooray (2cfe6)

v4.11.0

基础版

🚨 Breaking Changes

重构登录页面 - by @hooray (cb230)

🚀 Features

扩充 unocss 自定义 shortcuts - by @hooray (6f59d)
SvgIcon 组件支持传入本地图片，网络图片增加载入和失败状态 - by @hooray (e79bd)
引入 postcss-nested - by @hooray (2fe0f)

🐞 Bug Fixes

修复带参路由无法记录到标签栏中 - by @hooray (1e155)

专业版

🚨 Breaking Changes

重构登录页面 - by @hooray (cedbb)
移除 I18nSelector 组件 - by @hooray (c6444)

🚀 Features

Iframe路由支持动态传入src - by @hooray (0faf5)
扩展组件增加 i18n 支持 - by @hooray (30a33)
手动登出时，清空非固定和非常驻的标签页 - by @hooray (7c88a)
扩充 unocss 自定义 shortcuts - by @hooray (23b9b)
SvgIcon 组件支持传入本地图片，网络图片增加载入和失败状态 - by @hooray (818c8)
固定或常驻标签页可在相邻且同类型的标签页间拖动 - by @hooray (59fd4)
标准模块增加搜索项重置 - by @hooray (c4342)
引入 postcss-nested - by @hooray (1c631)

🐞 Bug Fixes

修复标签页可以拖动到固定或常驻标签页前面的问题 - by @hooray (089e0)

v4.10.0

基础版

🚨 Breaking Changes

移除createInjectionKey函数 - by @hooray (9a733)

🚀 Features

次导航支持隐藏 - by @hooray (23d36)
上传组件增加自定义上传 - by @hooray (66c0e)
FileUpload 组件文件列表增加下载功能 - by @hooray (bd5c9)

专业版

🚨 Breaking Changes

移除 menu.subMenuOnlyOneHide 应用配置项，修改为根据路由 meta.menu 配置实现相同效果 - by @hooray (85b56)
移除createInjectionKey函数，全局provide的generateI18nTitle函数放到useMenu()里提供 - by @hooray (fd2a5)
调整 menu.enableSubMenuCollapseButton 的展示逻辑 - by @hooray (64b73)

🚀 Features

上传组件增加自定义上传 - by @hooray (10295)
FileUpload 组件文件列表增加下载功能 - by @hooray (29fc0)

🐞 Bug Fixes

修复导航模式为精简和面板模式时，点击无子导航的主导航路由报错 - by @hooray (d99f2)
修复主题跟随系统且系统为明亮模式时，水印不生效 - by @hooray (038b4)

v4.9.0

基础版

🚨 Breaking Changes

配置项 menu.menuMode 变更为 menu.mode - by @hooray (57fcd)

🚀 Features

增加禁用开发者工具环境变量 - by @hooray (90b58)
新增哀悼模式和色弱模式 - by @hooray (456ef)

🐞 Bug Fixes

修复vscode失效配置 - by @hooray (3c8b4)
修复主导航 children 为空时报错 - by @hooray (9e444)

专业版

🚨 Breaking Changes

配置项 menu.menuActiveStyle 变更为 menu.style - by @hooray (d055f)
配置项 menu.menuMode 变更为 menu.mode - by @hooray (d4ce5)

🚀 Features

增加2种导航栏模式 side-panel / head-panel - by @hooray (14996)
新增tabbar.dblclickAction标签页双击执行动作配置项 - by @hooray (5092f)
增加禁用开发者工具环境变量 - by @hooray (b0037)
新增哀悼模式和色弱模式 - by @hooray (ea5ad)

🐞 Bug Fixes

修复类型警告 - by @hooray (26bd1)
移除无用逻辑判断 - by @hooray (55ee2)
修复vscode失效配置 - by @hooray (031db)
修复主导航 children 为空时报错 - by @hooray (62b56)

v4.8.2

基础版

🏎 Performance

优化标签栏滚动体验 - by @hooray (03e5e)

专业版

🏎 Performance

优化标签栏滚动体验 - by @hooray (971d9)

v4.8.1

基础版

🐞 Bug Fixes

修复后端返回路由数据中 children 为空数组导致菜单无法正常生成 - by @hooray (e0236)

专业版

🐞 Bug Fixes

修复后端返回路由数据中 children 为空数组导致菜单无法正常生成 - by @hooray (3c8e2)

v4.8.0

基础版

🚨 Breaking Changes

路由 meta.auth 保持元信息默认合并行为，路由访问改为通过 route.matched 进行逐级鉴权 - by @hooray (4911a)

🚀 Features

登录页增加扫码登录参考 - by @hooray (98d21)

🐞 Bug Fixes

修复一级路由设置 meta.menu: false 无效 - by @hooray (cb53f)
标签栏右键菜单自定义样式没在指定 class 范围内生效 - by @hooray (5269d)
标签栏解绑错误快捷键 - by @hooray (14583)
修复类型定义 - by @hooray (44949)

专业版

🚨 Breaking Changes

路由 meta.auth 保持元信息默认合并行为，路由访问改为通过 route.matched 进行逐级鉴权 - by @hooray (aad34)
路由meta.title支持设置i18n的key，同时meta.i18n进入弃用过渡期 - by @hooray (68e5c)

🚀 Features

LayoutContainer 组件支持设置侧边栏默认显示状态 - by @hooray (28708)
登录页增加扫码登录参考 - by @hooray (3a561)

🐞 Bug Fixes

修复水印开启报错 - by @hooray (06729)
修复一级路由设置 meta.menu: false 无效 - by @hooray (39522)
标签栏右键菜单自定义样式没在指定 class 范围内生效 - by @hooray (d8934)
标签栏解绑错误快捷键 - by @hooray (368ac)
修复类型定义 - by @hooray (13bd9)

v4.7.0

基础版

🚀 Features

路由增加 meta.menu 配置，同时 meta.sidebar 进入弃用过渡期 - by @hooray (04fa3)

🐞 Bug Fixes

修复 mock 模板请求无响应数据 - by @hooray (73074)
修复顶部导航鼠标滚动回弹 - by @hooray (107e8)
修复顶部导航数量过多，导致工具栏被遮挡 - by @hooray (a105d)
修复后端返回路由时，因为父级auth为空字符串或数组导致子级权限失效的问题 - by @hooray (c6167)
文件路由系统下,用户权限变化后,菜单不更新 - by @hooray (79184)

专业版

🚀 Features

提供 $t 函数,用于路由 meta.i18n 能在 VSCode I18n Ally 插件下正确显示 - by @hooray (641cd)
工具栏部分按钮增加交互动效 - by @hooray (26003)
支持 RTL 模式 - by @hooray (89879)
偏好设置增加默认语言 - by @hooray (f8727)
路由增加 meta.menu 配置，同时 meta.sidebar 进入弃用过渡期 - by @hooray (a9ab0)
RTL 模式下标签栏禁用拖拽排序 - by @hooray (64f58)
路由增加 meta.auths 配置 - by @hooray (54833)
路由增加 meta.alwaysOpened 配置项，支持始终展开 - by @hooray (86a16)

🐞 Bug Fixes

修复 mock 模板请求无响应数据 - by @hooray (051d9)
修复 RTL 模式在移动端下展示 bug - by @hooray (f5f6a)
修复顶部导航鼠标滚动回弹 - by @hooray (afcb3)
修复顶部导航数量过多，导致工具栏被遮挡 - by @hooray (a1e3a)
修复部分图标在 RTL 模式下的显示 - by @hooray (54b83)
修复后端返回路由时，因为父级auth为空字符串或数组导致子级权限失效的问题 - by @hooray (96a59)
文件路由系统下,用户权限变化后,菜单不更新 - by @hooray (4161d)

v4.6.2

基础版

无重大变化

专业版

无重大变化

v4.6.1

基础版

无重大变化

专业版

无重大变化

v4.6.0

基础版

无重大变化

专业版

🚀 Features

路由增加 meta.singleMenu 配置项 - by @hooray (2a9cb)

🐞 Bug Fixes

修复 IconPicker 组件样式错乱 - by @hooray (17ed3)

v4.5.0

基础版

🚀 Features

引入 unplugin-turbo-console 优化开发体验 - by @hooray (36c9a)
增加打包后生成存档文件支持 - by @hooray (06d6e)
增加图片支持，整站图标改用 unocss icon 方式使用，方便在内网环境使用 - by @hooray (52b25)
增加标签页支持 - by @hooray (a55f3)
导航菜单收起时，无二级的一级导航增加 tooltip 展示 - by @hooray (f9c1c)
明暗模式设置为跟随系统时，支持动态切换 - by @hooray (a8b41)
Vite-plugin-vue-devtools 替换 vite-plugin-vue-inspector - by @hooray (b4e0e)

🐞 Bug Fixes

Mock 数据修复 - by @hooray (1dd16)
修复导航模式切换到 single 时有几率报错 - by @hooray (0dfdb)
修复顶部模式下页面载入进度条被遮挡 - by @hooray (57044)
修复标签栏未开启时调用 useTabbar 内函数报错 - by @hooray (b6023)

专业版

🚨 Breaking Changes

重构用户偏好模块，偏好设置可存放在 localStorage - by @hooray (880d2)
重构页面水印，支持动态更新 - by @hooray (ba7b4)
移除内置 v-waves 指令，使用第三方 v-wave 插件 - by @hooray (491fb)

🚀 Features

引入 unplugin-turbo-console 优化开发体验 - by @hooray (b8a8b)
增加打包后生成存档文件支持 - by @hooray (0eeb3)
增加图片支持，整站图标改用 unocss icon 方式使用，方便在内网环境使用 - by @hooray (8b666)
标签页增加默认样式 - by @hooray (d8434)
导航菜单收起时，无二级的一级导航增加 tooltip 展示 - by @hooray (a22bc)
明暗模式设置为跟随系统时，支持动态切换 - by @hooray (9ff39)
Vite-plugin-vue-devtools 替换 vite-plugin-vue-inspector - by @hooray (01462)
增加 v-zoomable 图片预览指令 - by @hooray (45b75)

🐞 Bug Fixes

Mock 数据修复 - by @hooray (ba9ff)
修复导航模式切换到 single 时有几率报错 - by @hooray (2c853)
修复标签栏下拉菜单内标签项文字过长挤压图标的问题 - by @hooray (1e73d)
调整侧边栏阴影显示逻辑 - by @hooray (b2738)
修复标签栏关闭标签页动效失效 - by @hooray (344f9)
修复标签栏鼠标滚动回弹 - by @hooray (046e3)
修复标签栏标签页文字太长图标不显示 - by @hooray (cf9f1)
修复顶部模式下页面载入进度条被遮挡 - by @hooray (6206e)
阻止标签栏关闭按钮双击事件冒泡，修复快速点击时导致标签页最大化 - by @hooray (de084)
修复标签栏未开启时调用 useTabbar 内函数报错 - by @hooray (2fbfd)

v4.4.0

基础版

🚨 Breaking Changes

应用配置 toolbar 对象内属性调整 - by @hooray (75d81)
Vite-plugin-fake-server 替换 vite-plugin-mock - by @hooray (548ea)

🐞 Bug Fixes

修复路由 HTML5 模式下点击导航刷新页面的问题 - by @hooray (2b8a1)
修复 FixedActionBar 组件阴影样式未生效 - by @hooray (d908f)
修复次导航高度变化时，底部阴影不变化 - by @hooray (8dee9)
修复工具栏显示/隐藏逻辑 - by @hooray (d39f5)

专业版

🚨 Breaking Changes

应用配置 toolbar 对象内属性调整 - by @hooray (a4014)
Vite-plugin-fake-server 替换 vite-plugin-mock - by @hooray (35288)

🚀 Features

应用配置新增 menu.subMenuAutoCollapse ，支持次导航收起时，鼠标悬停临时展开 - by @hooray (132b6)
应用配置新增 toolbar.layout 属性，支持工具栏自定义布局 - by @hooray (df50e)

🐞 Bug Fixes

修复路由 HTML5 模式下点击导航刷新页面的问题 - by @hooray (694e4)
标签栏风格为方块时颜色缺失 - by @hooray (cc779)
修复 FixedActionBar 组件阴影样式未生效 - by @hooray (0f500)
修复次导航高度变化时，底部阴影不变化 - by @hooray (fecd4)
修复标签栏相关提示信息在快速操作下反复出现的问题 - by @hooray (f1ca3)
修复工具栏显示/隐藏逻辑 - by @hooray (e2f8d)

v4.3.0

基础版

🚨 Breaking Changes

应用配置 app.enableAppSetting 迁移到环境变量文件中 - by @hooray (8311a)

专业版

🚨 Breaking Changes

应用配置中 app.defaultLang 默认为空时，将不会在运行时被自动赋值 - by @hooray (cfafb)
应用配置 app.enableAppSetting 迁移到环境变量文件中 - by @hooray (9efbc)

🐞 Bug Fixes

全局搜索补充遗漏未处理的 i18n 字段 - by @hooray (c3c29)

v4.2.0

基础版

🚀 Features

应用配置增加 home.fullPath - by @hooray (28b8d)

专业版

🚀 Features

导航路由增加 newWindow 配置，支持在新窗口中打开 - by @hooray (767b7)
标签栏新增新窗口打开功能 - by @hooray (24757)
水印支持手动换行 - by @hooray (0deef)
应用配置增加 home.fullPath - by @hooray (61847)

🐞 Bug Fixes

导航精简模式下，主导航激活状态有时会失效 - by @hooray (5be6a)

v4.1.0

基础版

🐞 Bug Fixes

修复次导航第一个导航无子级路由时不显示 - by @hooray (7ba47)
修复次导航的显隐逻辑 - by @hooray (2e982)

专业版

🚨 Breaking Changes

标准模块中 SearchBar 组件调整为 grid 布局 - by @hooray (269a6)

🚀 Features

全局搜索支持拼音 - by @hooray (8d44c)

v4.0.3

基础版

🐞 Bug Fixes

修复文件系统路由下，导航栏无法展开多级和一级导航无法点击 - by @hooray (4df19)
搜索界面弹出时动画失效 - by @hooray (8aba0)

专业版

🐞 Bug Fixes

修复收藏夹默认存储位置错误 - by @hooray (a9e52)
修复文件系统路由下，导航栏无法展开多级和一级导航无法点击 - by @hooray (cd3b4)
搜索界面弹出时动画失效 - by @hooray (85a7a)

v4.0.2

基础版

无重大变化

专业版

🐞 Bug Fixes

修复 ColorfulCard 组件图标溢出 - by @hooray (865bb)

v4.0.1

基础版

🐞 Bug Fixes

修复火狐下样式兼容性问题 - by @hooray (95748)
修复 HTabList 组件文字不居中的问题 - by @hooray (ff2dd)
修复导航跳转时如果被中断，高亮位置不正确 - by @hooray (197d3)
修复 plop 无法使用 - by @hooray (2e4af)

专业版

🐞 Bug Fixes

修复火狐下样式兼容性问题 - by @hooray (31b6d)
修复 HTabList 组件文字不居中的问题 - by @hooray (e7acb)
修复导航跳转时如果被中断，高亮位置不正确 - by @hooray (13073)
修复 plop 无法使用 - by @hooray (e9987)

v4.0.0

拥抱原子化 CSS ，启用 UnoCSS ，并对框架部分组件样式进行了重构
如果你正在将老版本的业务代码向新版本迁移，推荐安装 UnoCSS 这个 VSCode 插件，它能高亮显示 UnoCSS 的代码。如果你的业务页面代码中定义的 class 和 UnoCSS 的 class 重名，也可以通过这个插件快速识别到并修改。
与 Element Plus 组件库解耦，方便替换成其他第三方 UI 组件库，详细可阅读：
- 《替换为 Ant Design Vue》
- 《替换为 Arco Design Vue》
- 《替换为 Naive UI》
- 《替换为 TDesign》
- 《替换为 Vexip UI》
- 《替换为 iDux》
ESLint 配置文件格式调整，详细可阅读《代码规范 - ESLint 配置》
ESLint 提供了全新的配置方式，所有配置项将都在一个 eslint.config.js 文件中实现。
基础版现在可以使用 Iconify 完整图标库，详细可阅读《图标 - Iconify 图标》
全新的主题配色方案，详细可阅读《主题 - 框架主题》

移除 Element Plus 自定义主题配置

如果你依旧需要自定义 Element Plus 的主题，可以阅读 Element Plus 官方文档《自定义主题》，或者参考下面提供的最佳实践。

在 /src/assets/styles/ 目录下分别新建 element-plus.scss 和 element-plus.dark.scss 并写入下面的代码：

scss

// element-plus.scss
@forward "element-plus/theme-chalk/src/common/var.scss" with (
  $colors: (
    "primary": (
      "base": green
    )
  )
);
@use "element-plus/theme-chalk/src/index.scss" as *;
@use "./element-plus.dark.scss" as *;

scss

// element-plus.dark.scss
@forward "element-plus/theme-chalk/src/dark/var.scss" with (
  $bg-color: (
    "page": #0a0a0a,
    "": #141414,
    "overlay": #1d1e1f,
  )
);
@use "element-plus/theme-chalk/src/dark/css-vars.scss" as *;

修改 /src/ui-provider/index.ts

...
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'
import 'element-plus/theme-chalk/dark/css-vars.css'
import '@/assets/styles/element-plus.scss'
...

移除应用配置中 Element Plus 默认尺寸的配置项
如果你依旧需要全局配置 Element Plus 的默认尺寸，可以参考《Config Provider 全局配置》并在 /src/ui-provider/index.vue 中进行修改。
移除精灵图支持
原有 /src/assets/sprites/ 目录中的图片，现在可以移动到 /src/assets/images/ 目录中，并修改代码中的使用方式。

应用配置中导航栏填充风格的配置项名称变更专业版

const globalSettings: Settings.all = {
  menu: {
    /**
    * 留空默认
    * radius 圆角
    */
    menuFillStyle: '', 
    // 导航栏是否圆角
    isRounded: false, 
  },
}

v3.x

前往 v3 文档查看

v2.x

前往 v2 文档查看

更新日志 ​

v4.12.1 ​

v4.12.0 ​

v4.11.0 ​

v4.10.0 ​

v4.9.0 ​

v4.8.2 ​

v4.8.1 ​

v4.8.0 ​

v4.7.0 ​

v4.6.2 ​

v4.6.1 ​

v4.6.0 ​

v4.5.0 ​

v4.4.0 ​

v4.3.0 ​

v4.2.0 ​

v4.1.0 ​

v4.0.3 ​

v4.0.2 ​

v4.0.1 ​

v4.0.0 ​

v3.x ​

v2.x ​

更新日志

v4.12.1

v4.12.0

v4.11.0

v4.10.0

v4.9.0

v4.8.2

v4.8.1

v4.8.0

v4.7.0

v4.6.2

v4.6.1

v4.6.0

v4.5.0

v4.4.0

v4.3.0

v4.2.0

v4.1.0

v4.0.3

v4.0.2

v4.0.1

v4.0.0

v3.x

v2.x