更新日志

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

4.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)

4.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)

4.6.2

基础版

无重大变化

专业版

无重大变化

4.6.1

基础版

无重大变化

专业版

无重大变化

4.6.0

基础版

无重大变化

专业版

🚀 Features

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

🐞 Bug Fixes

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

4.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)

4.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)

4.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)

4.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)

4.1.0

基础版

🐞 Bug Fixes

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

专业版

🚨 Breaking Changes

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

🚀 Features

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

4.0.3

基础版

🐞 Bug Fixes

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

专业版

🐞 Bug Fixes

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

4.0.2

基础版

无重大变化

专业版

🐞 Bug Fixes

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

4.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)

4.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/App.vue 中进行修改。
移除精灵图支持
原有 /src/assets/sprites/ 目录中的图片，现在可以移动到 /src/assets/images/ 目录中，并修改代码中的使用方式。

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

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