v3-admin-vite

❗❓

注意：本次更新切换了在线 mock 接口地址，旧接口将无法继续使用，望周知~ 同时，项目将在后续版本中（争取在 4.4.1 版本）采用更加稳定的 apifox mock 来作为在线接口！

Feat

• 为精简代码，新增 hook：useLayoutMode
• 为精简代码，新增 hook：useDevice

Refactor

• 再次精简路由守卫逻辑
• 采用 vue 3.4 新增的 defineModel 宏来精简代码
• 重构 element-plus table 示例代码，使逻辑更加清晰，通用性更强

Fix

• 修复禁用动态路由后，用户名不显示的问题
• 修复子路由设置 hidden: true 不生效的问题
• 修复处于顶部模式时 el-menu 未自适应宽度去折叠的问题 (#153)

Perf

• 新版 vue 已修复热更新导致的页面白屏问题，项目移除相关的代码

Types

• 隐藏无须处理的 ts 报错

Chore

• 切换在线 mock 接口地址
• 升级并适配 element-plus 2.5.5
• 更新新版 VSCode codeActionsOnSave 配置
• 升级并适配 vue 3.4
• 适配 vite 5
• fixed vxe-table 4.4.1 && update other dependencies

❗❓

本次 4.3.0 版本将 vite 版本升级到了 5.x，需要有一下几点特别注意事项：

• node 版本 18.x 或 20+
• pnpm 版本 8.x 或最新版

Perf

• 开启 vite5 的预热功能，提高初始页面加载速度

Chore

• upgrade the vite version to 5.x
• fixed vxe-table 4.4.1 && update other dependencies
• update deploy.yml

Fix

• sidebar scroll area is abnormal (#134)

Style

• 优化 element-plus 2.4.0 版本表格暗黑模式下样式
• 优化 element-plus 2.4.1 版本下 el-menu--horizontal 样式
• 解决顶部模式下 navigation-bar 背景色遮挡了下方阴影的问题

Docs

• 完善 CompConsumer 组件注释
• 新增三级及其以上路由缓存功能的文案提示

Chore

• 移除废弃的 mock api
• fixed vxe-table 4.4.1 && update other dependencies
• update deploy.yml

Feat

• 新增页脚 Footer 组件

Refactor

• 重构 router/permission 使其更易读 (#133)

Fix

• 解决 app-scrollbar 高度未占满 app-main 的问题 (#128)
• 解决左侧布局模式下取消固定 header 导致 header 底部阴影丢失的问题 (#129)

Perf

• 全局水印采用 fixed 布局，以兼容更多的细节场景
• 使用 %placeholder 代替 @mixin (#131)(#132)

Style

• 添加导入类型时遗漏的 type 标识

Chore

• fixed vxe-table 4.4.1 && update other dependencies

Feat

• 新增 useRouteListener，系统统一采用该 hook 监听路由变化
• 新增一种 keep-alive 缓存备用方案 (#119)
• 新增动态标题 hook (useTitle)
• 新增带有防御功能的水印 hook (useWatermark) 以及示例

Fix

• 合并路由守卫中重复的钩子

Perf

• 优化 useFullscreenLoading hook 示例 (#121)
• 优化单独监听路由浪费渲染性能的问题 (#120)

Chore

• fixed vxe-table 4.4.1 && update other dependencies

Docs

• vite 配置选项 chunkSizeWarningLimit 注释优化 (#122)

Fix

• 搜索菜单项路径为外链时无法跳转 (#111)
• 修复 <transition> 和 <keep-alive> 组合使用导致的页面空白 (#114)

Perf

• 优化构建速度 (#112)
• 优化 router-view 绑定 key 的方式

Chore

• el-config-provider 组件采用短横线方式

Docs

• 更新消息通知文案时间 (#117)

Feat

• 支持三级及其以上路由的 keep-alive 缓存 (#93)
• 新增菜单搜索功能 (#96)
• 新增返回顶部功能

Fix

• 修复侧边栏菜单高亮 bug (#108)
• 解决项目配置的缓存项少于实际所需项数时导致的页面空白问题

Perf

• 将可替换的 getCssVariableValue 取值代码替换为直接使用 css var

Style

• 伪元素统一采用双冒号格式

Chore

• 更新 vite/client 配置
• 简化反向代理配置
• fixed vxe-table 4.4.1 && update other dependencies

Docs

• update the README

Feat

• 拓展全屏组件，支持内容区放大和内容区全屏两种模式
• 路由白名单功能兼容匹配路由 path 和 name 两种方式
• 新增标签栏缓存功能
• 新增项目配置面板缓存功能和重置功能
• 新增多种布局模式（左侧模式、顶部模式、混合模式）🎉

Chore

• 固定 vxe-table 版本为 4.4.1，升级其他所有依赖
• 切换新的 mock api 服务

🎉🎉🎉

本次 4.0.0 版本对代码的更新几乎覆盖了所有文件，针对每一处可优化的地方都做了对应的代码重构！

• 更精简的代码风格
• 更全面的类型提示
• 更推荐的 Vue 语法
• 更多更详细的注释
• 更统一的命名风格

Feat

• 补全深蓝模式下，primary 颜色各种状态 (#81)
• 新增 service.ts 对二进制数据的处理逻辑 (#86)
• 优化滚动条样式 (#84)

Fix

• 修复控制台告警 “Added non-passive event listener to a scroll-blocking 'wheel' event”
• 启用 pnpm shamefully-hoist 配置，用以修复 vue 组件和 element plus 组件没有类型提示的问题

Perf

• 完成项目的深度优化

Chore

• 移除 vitest/globals 配置
• 移除按需引入相关代码
• 固定 vxe-table 版本为 4.4.1，升级其他所有依赖

Docs

• 新增 npmrc 配置注释
• 修改 app-loading.css 注释类型

CI

• 升级到 node 18.x 和 pnpm 8.6.3

Feat

• 补全深蓝模式下，primary 颜色各种状态 (#81)
• 新增 service.ts 对二进制数据的处理逻辑 (#86)
• 优化滚动条样式 (#84)

Fix

• 启用 pnpm shamefully-hoist 配置，用以修复 vue 组件和 element plus 组件没有类型提示的问题

Perf

• 深度优化所有代码（已进行 90%）

Chore

• 升级所有三方依赖版本

CI

• 更新 github workflows 中 pnpm 版本为 8.6.2

Feat

• 优化 main.ts，使 router 准备就绪后再挂载页面 (#71)
• 深蓝主题下对 Element Plus 颜色的覆盖进行扩展 (#57)

Fix

• 修复用 img src 显示 svg 图片时 src 地址指向对象的问题
• 修复隐藏 TagsView 后，路由 keepAlive: true 无效的问题 (#66)
• 修复 NODE_ENV=production is not supported in the .env file 警告

Refactor

• 使用 watchEffect 来收集主题相关的副作用 (#64) (#65)

Chore

• 升级所有三方依赖版本
• 采用 Pnpm 8.x
• 适配 Vite 4.3.x （性能更强）
• 适配 Vue 3.3.x（defineEmits 和 defineOptions）
• 引入 Element Plus Global Components 类型文件（解决某些依赖（比如 vxe-table 4.2.7-beta.0 ~ 4.3.11 和 vue-router 4.2.0）导致的没有 Element Plus 组件类型提示的问题）

Style

• 统一 Props 命名风格

Docs

• 更新 README.md 和 README.zh-CN.md
• 修正权限函数报错提示文案

CI

• 更新 github workflows

Feat

• "tags-view" support wheel scroll (#62)
• "tag" outside the viewport is automatically moved to the viewable area

Refactor

• 优化 useTheme 代码结构
• 更改 "欢迎 star 标语" 代码位置

Fix

• 修复角色数组为空时导致路由守卫无限循环的问题
• 修复左侧导航菜单背景颜色异常 (#61)

Types

• 优化表格数据类型
• 统一导入类型的方式

Docs

• 添加手摸手教程链接地址

Chore

• 升级三方依赖版本

Feat

• 新增 keep alive 缓存功能
• 新增两份用于 vscode 一键生成 vue3 代码的 .code-snippets 文件

Fix

• Fix folder naming errors

Types

• 优化 useFullscreenLoading 的类型（闭包的泛型）
• 将类型和接口定义进行拆分

Test

• 集成 vitest 单元测试框架
• 添加单元测试示例

Chore

• 升级了所有的三方依赖到最新版本

Feat

• 新增内容区全屏功能
• 新增灰色、色弱模式
• 新增下拉选择框 hook：useFetchSelect
• 新增全屏 loading hook：useFullscreenLoading
• 接口响应数据格式支持通过泛型推导

Fix

• 修复 el-scrollbar api 变动导致的获取滚动可视区宽度失败问题

Docs

• 更新注释和文档

Chore

• 升级了所有的三方依赖到最新版本（vite 版本更新至 4.x）

Feat

• 新增消息通知功能
• 头像右侧新增用户名显示

Fix

• 修复表格分页组件在移动端页面超出页面的问题

Perf

• 右侧面板按钮定位方式改为 fixed

Style

• 优化 table 示例样式

Docs

• 更新部分注释 & 文档
• 添加欢迎 star 标语

Chore

• updates all dependencies

Feat

• 新增 Element Plus Table 示例
• 新增 Vxe Table 示例 (#22)
• 新增深蓝色主题模式
• 封装全局的分页 hook (#23)

Refactor

• 重构 main.ts

Fix

• useTheme use single ref (#21)
• 获取用户详情接口更换为 get 请求

Style

• 调整全局背景色 & 添加 unocss 类名前缀
• 多主题统一采用 el-color-primary 为主题色

Docs

• 更新部分注释 & 文档

Chore

• add eslint cache
• format 'import type'
• updates all dependencies

Refactor

• 将多主题功能从 pinia 抽离为 hook
• theme styles
• error page
• login page verification code

Docs

• update README

Chore

• new logo
• updates all dependencies

Feat

• 路由的 icon 配置项支持 Element Plus 的 Icon 组件 (#19)
• 新增 TagsView 组件点击按钮左右滚动功能 (#20)

Docs

• Readme in English (#15)

Style

• 优化左侧导航栏样式

Chore

• 升级了所有的三方依赖到最新版本

Feat

• 进入 404 页面时保留当前 URL (#14)

Refactor

• 优化 error page 页面

Style

• 样式穿透使用最新的 :deep() 语法 (#13)

Chore

• 升级了所有的三方依赖到最新版本
• dev 环境下更换为通过反向代理方式访问接口

Refactor

• 采用 Easy Mock 模拟真实的后端接口

Style

• 统一采用 import type 语法导入类型

Chore

• 升级了所有的三方依赖到最新版本