Fantastic-admin 官方文档

Appearance

更新日志 ​

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

v5.5.0 ​

基础版

🚨 Breaking Changes

  • 新增 FaImagePreview 组件，并移除 ImagePreview 组件  -  by @hooray (1a0eb)
  • 移除 useViewTransition 函数封装  -  by @hooray (0ac47)
  • Pinia store 改为自动导入  -  by @hooray (8d597)
  • 扩展路由 close 函数，并移除 useTabbar 中 close 函数  -  by @hooray (59e68)

🚀 Features

  • 新增 FaButtonGroup 组件  -  by @hooray (e553f)
  • FaModal 组件增加 beforeClose 回调函数，优化关闭逻辑并支持异步处理  -  by @hooray (6febf)
  • 为 FaTabs 组件添加 listClass 和 contentClass 属性，以支持自定义样式  -  by @hooray (e3aa5)
  • FaDrawer 和 FaModal 组件新增 destroyOnClose 属性  -  by @hooray (6fc89)
  • 个人设置弹窗适配移动端  -  by @hooray (bfe66)
  • 标签页右键菜单补充图标  -  by @hooray (e2cd4)
  • Vite 升级到 7.0  -  by @hooray (fa537)

🐞 Bug Fixes

  • 更新viewport设置以改善移动设备上的显示效果  -  by @hooray (4ef21)
  • 修复权限未开启时菜单未过滤的问题，并简化菜单过滤逻辑  -  by @hooray (3859c)
  • 修复账户按钮移动端次导航下不实现用户名  -  by @hooray (28cc8)

🏎 Performance

  • 优化导航菜单动效执行性能  -  by @hooray (7ee93)

专业版

🚨 Breaking Changes

  • 简化页宽模式，仅保留自适应和居中两种模式  -  by @hooray (37735)
  • 新增 FaImagePreview 组件，并移除 ImagePreview 组件  -  by @hooray (b5251)
  • 移除 useViewTransition 函数封装  -  by @hooray (45e3b)
  • Pinia store 改为自动导入  -  by @hooray (427e9)
  • 扩展路由 close 函数，并移除 useTabbar 中 close 函数  -  by @hooray (2b7aa)
  • 路由增加 meta.tabMerge 属性，移除应用配置中标签页合并配置项  -  by @hooray (e717e)
  • Storage 前缀配置移入环境变量配置文件中  -  by @hooray (6d058)
  • 移除 storage 工具函数，重写了 localStorage 和 sessionStorage ，可直接使用原生 API  -  by @hooray (2470e)

🚀 Features

  • 新增 FaMultiStepLoader 组件  -  by @hooray (f2f57)
  • 新增 FaButtonGroup 组件  -  by @hooray (5b455)
  • FaModal 组件增加 beforeClose 回调函数，优化关闭逻辑并支持异步处理  -  by @hooray (0046b)
  • FaTabs 组件增加 listClass 和 contentClass 属性以支持自定义样式  -  by @hooray (588af)
  • 新增导航栏暗黑模式，可在亮色模式下启用  -  by @hooray (7e17a)
  • FaDrawer 和 FaModal 组件新增 destroyOnClose 属性  -  by @hooray (dd5e4)
  • 在 FaStorageBox 组件中新增名称验证提示，确保名称不能为空且不重复  -  by @hooray (02b22)
  • 个人设置弹窗适配移动端  -  by @hooray (55537)
  • 标签页右键菜单补充图标  -  by @hooray (1bebb)
  • Vite 升级到 7.0  -  by @hooray (010d0)

🐞 Bug Fixes

  • 更新viewport设置以改善移动设备上的显示效果  -  by @hooray (fce07)
  • 修复权限未开启时菜单未过滤的问题，并简化菜单过滤逻辑  -  by @hooray (0023f)
  • 修复标签页移出动画乱飘  -  by @hooray (27c5f)
  • 修复账户按钮移动端次导航下不实现用户名  -  by @hooray (422a9)
  • 修复暗黑导航栏始终展开菜单字体颜色显示错误  -  by @hooray (e158c)
  • 修复 FaTimeline 组件数据少于或等于1条时候报错  -  by @hooray (8fead)
  • 修复页面最大化时边距计算错误  -  by @hooray (259c3)

🏎 Performance

  • 优化导航菜单动效执行性能  -  by @hooray (f1b74)

v5.4.0 ​

基础版

🚀 Features

  • FaScrollArea 组件新增 onScroll 事件  -  by @hooray (9b500)
  • 对未设置 redirect 的父路由，访问时将自动重定向到允许访问的子路由  -  by @hooray (8d4e2)
  • 新增 FaHoverCard 组件  -  by @hooray (eb306)
  • 新增 FaProgress 组件  -  by @hooray (b7c62)
  • 增加请求重试机制  -  by @hooray (3b889)
  • 将 FaDropdown 组件插槽名从 label 修改为 header，并新增 footer 插槽  -  by @hooray (b9741)

🐞 Bug Fixes

  • 优化菜单点击处理逻辑，增加对链接的判断  -  by @hooray (9f374)
  • 修复次导航收起时页面展示错误  -  by @hooray (05261)
  • 修复激活标签页定位可能不居中的问题  -  by @hooray (8bfa0)

专业版

🚨 Breaking Changes

  • 调整 FaLayoutContainer 组件 props  -  by @hooray (f97c1)

🚀 Features

  • FaScrollArea 组件新增 onScroll 事件  -  by @hooray (46cb9)
  • 新增 FaTimeline 组件  -  by @hooray (f34d6)
  • 对未设置 redirect 的父路由，访问时将自动重定向到允许访问的子路由  -  by @hooray (8c7ab)
  • 新增 FaHoverCard 组件  -  by @hooray (d9ea7)
  • 新增 FaProgress 组件  -  by @hooray (ebbed)
  • 增加请求重试机制  -  by @hooray (76e84)
  • 将 FaDropdown 组件插槽名从 label 修改为 header，并新增 footer 插槽  -  by @hooray (6cd57)

🐞 Bug Fixes

  • 修复工具栏 i18n 按钮动画只能执行一次  -  by @hooray (914e9)
  • 优化 zoomable 指令可能会多次创建实例  -  by @hooray (1203d)
  • 优化菜单点击处理逻辑，增加对链接和新窗口的判断  -  by @hooray (fd88e)
  • 修复 FaPagination 组件修改当前页码后视图不更新的问题  -  by @hooray (fd47e)
  • 修复次导航收起时页面展示错误  -  by @hooray (37fcb)
  • 修复激活标签页定位可能不居中的问题  -  by @hooray (8ab76)

v5.3.0 ​

基础版

🚀 Features

  • FileUpload 组件增加 onRemove 事件回调  -  by @hooray (59560)
  • 将账号信息按钮封装为 AccountButton 组件，并优化工具栏和导航栏的显示逻辑  -  by @hooray (a1d32)
  • 新增预设插槽 header-after-menu、main-sidebar-after-menu 和 sub-sidebar-after-menu  -  by @hooray (d7808)
  • 新增工具栏全局开关设置  -  by @hooray (f8794)

🐞 Bug Fixes

  • 修复 FaDrawer 和 FaModal 组件中遗漏的 props  -  by @hooray (97757)
  • 修复导航logo在禁用主页时依旧显示可点击状态  -  by @hooray (3be15)

专业版

🚀 Features

  • FileUpload 组件增加 onRemove 事件回调  -  by @hooray (32fcc)
  • 新增 FaAnimatedCountTo 组件  -  by @hooray (b3a73)
  • 将账号信息按钮封装为 AccountButton 组件，并优化工具栏和导航栏的显示逻辑  -  by @hooray (fb498)
  • 新增预设插槽 header-after-menu、main-sidebar-after-menu 和 sub-sidebar-after-menu  -  by @hooray (f850a)
  • 新增工具栏全局开关设置  -  by @hooray (06966)

🐞 Bug Fixes

  • 修复 FaDrawer 和 FaModal 组件中遗漏的 props  -  by @hooray (c9d20)
  • 修复登录页 copyright 展示位置错误  -  by @hooray (ce8bf)
  • 修复导航logo在禁用主页时依旧显示可点击状态  -  by @hooray (009d3)

v5.2.0 ​

基础版

🚨 Breaking Changes

  • Radix-vue 迁移到 reka-ui  -  by @hooray (dcad2)
  • 重写路由 push/go/replace 函数，移除 useTabbar 中 open/go/replace 函数  -  by @hooray (2b18c)

🚀 Features

  • FaDivider 增加 class props  -  by @hooray (b533c)
  • Layouts 布局支持 <Suspense>  -  by @hooray (ce747)
  • 新增 FaSlider 组件  -  by @hooray (f0229)
  • 增加 cursor 配置  -  by @hooray (b0ac0)

🐞 Bug Fixes

  • FaContextMenu z-index 被遮挡  -  by @hooray (ebf61)
  • 修复 FaDrawer 组件 contentClass 设置无效  -  by @hooray (5bfb3)
  • 浏览器不支持 color-mix 时，框架主题不会同步至 element-plus 主题  -  by @hooray (609e7)
  • 在路由守卫中捕获异常时，添加登出逻辑  -  by @hooray (5fcd3)

🏎 Performance

  • 优化导航菜单  -  by @hooray (5e59d)
  • 优化子菜单过渡效果，支持两套实现方案  -  by @hooray (10c84)

专业版

🚨 Breaking Changes

  • Radix-vue 迁移到 reka-ui  -  by @hooray (5b45b)
  • 重写路由 push/go/replace 函数，移除 useTabbar 中 open/go/replace 函数  -  by @hooray (8ca74)

🚀 Features

  • FaDivider 增加 class props  -  by @hooray (73e87)
  • 新增 FaFlipCard 组件  -  by @hooray (87122)
  • 新增 FaLinkPreview 组件  -  by @hooray (28b3c)
  • 新增 FaInteractiveButton 组件  -  by @hooray (27c12)
  • 新增 FaGradientButton 组件  -  by @hooray (595c2)
  • 新增 FaMarquee 组件  -  by @hooray (7efc5)
  • 新增 FaBlurReveal 组件  -  by @hooray (b4d6d)
  • 新增 FaParticlesBg 组件  -  by @hooray (8f9af)
  • 新增 FaTextHighlight 组件  -  by @hooray (9e1a0)
  • 新增 FaFlipWords 组件  -  by @hooray (83e7f)
  • 新增 FaGlowyCardWrapper / FaGlowyCard 组件  -  by @hooray (e3191)
  • 新增 FaAnimatedBeam 组件  -  by @hooray (e305e)
  • 新增 FaSparklesText 组件  -  by @hooray (500cf)
  • FaAnimatedBeam 组件增加虚线光束支持  -  by @hooray (0fa92)
  • 新增 FaSpotlightCard 组件  -  by @hooray (9792b)
  • 新增 useConfetti 函数  -  by @hooray (2d665)
  • 新增 FaPatternBg 组件  -  by @hooray (7a063)
  • 新增 FaScratchOff 组件  -  by @hooray (a09f3)
  • 新增 FaBorderBeam 组件  -  by @hooray (b290c)
  • 增加 layout.widthModeScope 应用配置  -  by @hooray (20d02)
  • Layouts 布局支持 <Suspense>  -  by @hooray (27f8e)
  • 新增 FaCarousel 组件  -  by @hooray (62806)
  • 新增 FaSlider 组件  -  by @hooray (f2c9e)
  • 增加 cursor 配置  -  by @hooray (ec799)
  • FaCode 组件增加 class 属性  -  by @hooray (5b04b)
  • 新增 FaCodePreview 组件  -  by @hooray (1be49)

🐞 Bug Fixes

  • FaContextMenu z-index 被遮挡  -  by @hooray (511f6)
  • 修复 FaDrawer 组件 contentClass 设置无效  -  by @hooray (9215d)
  • 浏览器不支持 color-mix 时，框架主题不会同步至 element-plus 主题  -  by @hooray (7e6a9)
  • 修复 FaGlowyCard 组件在移动端下导致页面无法滑动的问题  -  by @hooray (7e420)
  • 修复路由 meta.permanent 参数失效  -  by @hooray (325d6)
  • 修复页宽模式在移动端布局错乱  -  by @hooray (2bd6c)
  • 在路由守卫中捕获异常时，添加登出逻辑  -  by @hooray (d95ee)
  • 修复主导航文字不显示  -  by @hooray (867f0)

🏎 Performance

  • 优化导航菜单  -  by @hooray (951d0)
  • 优化子菜单过渡效果，支持两套实现方案  -  by @hooray (f3858)

v5.1.0 ​

基础版

🚨 Breaking Changes

  • 重构注册路由数据结构  -  by @hooray (cfb4f)

🚀 Features

  • FaSelect 组件增加 class props  -  by @hooray (eff07)
  • 刷新按钮增加按住ctrl使用原生浏览器刷新功能  -  by @hooray (2100b)
  • 增加 vue devtools 启动编辑器环境变量  -  by @hooray (643d4)
  • FaPopover 组件增加手动控制面板显示  -  by @hooray (6d58f)

🐞 Bug Fixes

  • 导航搜索面板唤起时输入框未聚焦  -  by @hooray (a6e66)
  • 修复 useFaModal 弹窗警告  -  by @hooray (b3b89)

专业版

🚨 Breaking Changes

  • 重构注册路由数据结构  -  by @hooray (c0d8b)

🚀 Features

  • FaSelect 组件增加 class props  -  by @hooray (83e5a)
  • 新增 FaCode 组件  -  by @hooray (ac4e1)
  • 刷新按钮增加按住ctrl使用原生浏览器刷新功能  -  by @hooray (a152b)
  • FaLayoutContainer 组件增加顶部底部区域  -  by @hooray (66def)
  • 增加 vue devtools 启动编辑器环境变量  -  by @hooray (f1e86)
  • FaPopover 组件增加手动控制面板显示  -  by @hooray (9c961)

🐞 Bug Fixes

  • 导航搜索面板唤起时输入框未聚焦  -  by @hooray (0611c)
  • 修复 useFaModal 弹窗警告  -  by @hooray (a2384)

v5.0.0 ​

此版本有较多破坏性的变更，如果打算从 v4.x 升级，请仔细阅读并谨慎迁移代码。

  • 引入 shadcn-vue ，内建组件和部分扩展组件基于 shadcn-vue 进行重构

  • 系统主题重构，挑选了 shadcn-vue 中的 8 款主题并进行定制

  • 所有内建组件名均改为 Fa 开头，例如 FaButton 。部分扩展组件也转为内建组件，例如 FaPageHeader 。新增了一系列基于 shadcn-vue 的组件，例如 FaPopover 。为与扩展组件做区分，内建组件存放在 /src/ui/components/ 目录下

  • 登录页使用内建组件进行重构，不再依赖 element-plus ，更方便迁移其他 UI 组件库

  • 新增 app.themeSync 应用设置

  • 路由 meta 配置项调整：

    • 移除 meta.i18n ，meta.title 支持国际化
    • 移除 meta.sidebar ，改为 meta.menu
    • 移除 meta.paddingBottom ，改为由框架自动处理
    • 新增 meta.badgeVariant ，用于设置导航徽章颜色
    • 新增 meta.query ，用于设置点击导航时进行路由跳转时，携带的参数
    • 新增 meta.maximize ，用于设置访问导航的路由时，是否最大化
    • 新增 meta.exitMaximize ，用于设置离开导航的路由时，是否退出最大化
    • 新增 meta.sort ，用于设置导航的排序

  • 主导航增加徽章和徽章颜色设置

  • 新增 app.loginExpiredMode 应用设置，设置登录状态过期后的行为

  • 新增 app.enableCheckUpdates 应用设置，检查网站是否有更新

  • 移除 menu.switchMainMenuAndPageJump 应用设置，新增 menu.mainMenuClickMode 应用设置，更灵活控制主导航的点击行为

  • 增加全局插槽，用于在导航、顶栏等位置插入自定义内容

v4.x ​

前往 v4 文档查看

v3.x ​

前往 v3 文档查看

v2.x ​

前往 v2 文档查看

Copyright © 2020-present Fantastic-admin