Compare commits

..
780 Commits
Author SHA1 Message Date
Hooray 468b7e011b v5存档 2026-03-31 02:12:25 +08:00
Hooray 4eb6b057b8 更新依赖 2026-03-31 01:52:57 +08:00
Hooray 0b04270de7 types 2026-03-25 22:26:57 +08:00
Hooray 9460e6d4d0 修复 FaSelect options 数组为空报错 2026-03-25 22:12:14 +08:00
Hooray f343f63840 更新依赖 2026-03-25 22:09:46 +08:00
Hooray 7c8dec3421 更新依赖 2026-03-15 02:13:26 +08:00
Hooray d0d0990f7c 优化路由守卫逻辑,简化条件判断和重定向处理 2026-03-07 15:11:58 +08:00
Hooray fed4dbcbde 更新依赖 2026-03-07 11:59:50 +08:00
Hooray 7c17dd6e5a 修复 overscroll-behavior 属性行为在 chrome 144 变更引起的 bug 2026-01-22 22:30:06 +08:00
Hooray 357620b6bf 更新依赖 2025-12-28 04:24:05 +08:00
Hooray 18477eff52 更新依赖 2025-12-25 13:13:30 +08:00
Hooray c5aea0449b 优化明暗切换过渡效果 2025-12-02 01:46:03 +08:00
Hooray c08fba325b 移除注册表单中的验证码字段 2025-11-10 15:39:22 +08:00
Hooray 943f68e0e0 移除 FaDrawer / FaModal 组件内置的 FaScrollArea 组件 2025-11-09 19:56:22 +08:00
Hooray 663c195da1 更新依赖 2025-11-09 19:29:57 +08:00
Hooray 31ab568563 修复FaImagePreview组件更改src值后不重置加载状态问题 2025-11-05 02:15:05 +08:00
Hooray 24a2887aa3 useFaModal 示例扩充 2025-10-31 18:24:31 +08:00
Hooray 81b4cab380 更新依赖 2025-10-23 14:29:43 +08:00
Hooray ebbbfceac9 修复自定义内容不生效 2025-10-10 15:08:45 +08:00
Hooray 1888297a2c 更新依赖 2025-10-08 12:42:24 +08:00
Hooray 91fb70b2c5 修复明暗主题切换动画闪烁 2025-09-25 18:38:37 +08:00
Hooray fdfbafea0a 主导航切换演示示例调整 2025-09-22 16:36:08 +08:00
Hooray fda3adf95a 修复 FaSwitch 图标不居中 2025-09-22 16:33:31 +08:00
Hooray 3b2f69d127 修复 FaImagePreview 预览时警告 2025-09-22 15:38:48 +08:00
Hooray cf41d7cc8c 更新依赖 2025-09-17 02:04:53 +08:00
Hooray 1a550c5385 移除 FaScrollArea 组件中的垂直滚动逻辑 2025-09-12 14:43:22 +08:00
Hooray c87c9f6c07 新增 FaCollapsible 组件 2025-09-05 16:25:33 +08:00
Hooray 60bb408ccc FaCheckbox 支持半选状态 2025-09-05 16:15:13 +08:00
Hooray 705f14e415 修复 FaFileUpload 和 FaImageUpload 在表单中点击可能会触发表单提交 2025-09-05 16:10:50 +08:00
Hooray 3990c4f437 更新依赖 2025-09-01 10:11:39 +08:00
Hooray eee125d2c7 修复 FaPinInput 组件输入bug 2025-09-01 00:24:07 +08:00
Hooray 8f2745ab59 优化标签页快捷键跳转逻辑 2025-08-15 11:29:54 +08:00
Hooray f1202cae20 FaSelect 组件支持更多类型 2025-08-13 10:28:07 +08:00
Hooray 8daee24eba 优化请求错误处理逻辑 2025-08-13 00:30:04 +08:00
Hooray b52578283c 更新依赖 2025-08-10 10:51:10 +08:00
Hooray 7c3d3820c2 优化响应拦截器逻辑 2025-08-08 17:44:58 +08:00
Hooray 48772f9003 useFaModal 和 useFaDrawer 页面卸载时自动清理 2025-08-06 18:06:35 +08:00
Hooray 8cbb3402da 确保 router.close 方法在 router.push 后处理 tabbar 状态 2025-08-05 23:43:34 +08:00
Hooray 1dd7a03a84 增加 FaTextarea 组件 2025-08-02 14:49:16 +08:00
Hooray 95a128372b FaSlider 组件增加 tooltip 属性 2025-08-02 03:59:53 +08:00
Hooray 42b1d20652 调整 FaDrawer 和 FaModal 组件的底部样式,增加内边距 2025-08-02 03:56:54 +08:00
Hooray cbe373c061 添加单选按钮组示例 2025-08-02 03:54:26 +08:00
Hooray 85e67c4fea 优化次导航第一层最深路径解析逻辑 2025-07-31 23:05:00 +08:00
Hooray 22ab17fb25 优化菜单项初始化逻辑 2025-07-30 23:51:26 +08:00
Hooray cd8eff5f97 修复 FaDrawer and FaModal 组件在头部不显示时的警告 2025-07-30 22:16:31 +08:00
Hooray e4ef6449e0 FaModal 和 FaDrawer 组件添加 zIndex 属性 2025-07-30 21:43:41 +08:00
Hooray 522a97f8d6 重构 useFaModal 和 useFaDrawer 2025-07-29 00:57:27 +08:00
Hooray 59fb213060 优化页面缓存逻辑 2025-07-28 20:32:08 +08:00
Hooray d4ca52ea8d 更新依赖 2025-07-25 15:20:15 +08:00
Hooray 17953c7645 FaModal 和 FaDrawer 分别增加命令式调用API 2025-07-25 14:09:57 +08:00
Hooray 5726479100 优化 tabId ,排除路由中的 query 参数 2025-07-21 10:19:55 +08:00
Hooray 3946adaecb 更新依赖 2025-07-18 14:18:22 +08:00
Hooray 7d27b74846 移除无用演示页面 2025-07-10 14:22:51 +08:00
Hooray 058f42fb37 修复 FaButtonGroup 组件的按钮边框样式,确保在非最后一个和非第一个按钮时正确应用圆角样式 2025-07-05 15:42:40 +08:00
Hooray d25dbeffdc 新增 FaFileUpload 组件,移除 FileUpload 组件 2025-07-05 15:41:00 +08:00
Hooray fb70031109 新增 FaImageUpload 组件,移除 ImageUpload 和 ImagesUpload 组件 2025-07-03 23:56:11 +08:00
Hooray f5bda00696 FaImagePreview 组件函数式调用增加多图支持 2025-07-02 15:16:09 +08:00
Hooray 60a3c4d3a1 FaImagePreview 组件增加函数式调用 2025-07-02 01:45:24 +08:00
Hooray 00f729340c 修复自动生成 store 文件目录错误 2025-06-30 15:20:47 +08:00
Hooray d076de4094 更新依赖 2025-06-29 18:17:47 +08:00
Hooray 366396c9d9 vite 升级到 7.0 2025-06-26 17:38:16 +08:00
Hooray 44717364d2 标签页右键菜单补充图标 2025-06-25 18:33:32 +08:00
Hooray 52012d46fa 个人设置弹窗适配移动端 2025-06-24 10:11:13 +08:00
Hooray e61465f75e 扩展路由 close 函数,并移除 useTabbar 中 close 函数 2025-06-21 15:19:47 +08:00
Hooray 97b15818b5 pinia store 改为自动导入 2025-06-17 12:37:10 +08:00
Hooray 5366aeb185 移除 useViewTransition 函数封装 2025-06-16 11:37:51 +08:00
Hooray 9ce9f36a10 新增 FaImagePreview 组件,并移除 ImagePreview 组件 2025-06-15 23:52:04 +08:00
Hooray e2c0eb5292 FaDrawer 和 FaModal 组件新增 destroyOnClose 属性 2025-06-13 16:06:11 +08:00
Hooray 3259ef0c9c 修复账户按钮移动端次导航下不实现用户名 2025-06-12 11:29:58 +08:00
Hooray c6c71b42d0 优化主题样式和全局样式引入 2025-06-12 02:08:33 +08:00
Hooray 4c23c8b55e 优化导航菜单动效执行性能 2025-06-11 18:26:50 +08:00
Hooray 3fe319e033 为 FaTabs 组件添加 listClass 和 contentClass 属性,以支持自定义样式 2025-06-11 10:08:00 +08:00
Hooray 801d346bc7 FaModal 组件增加 beforeClose 回调函数,优化关闭逻辑并支持异步处理 2025-06-10 14:39:35 +08:00
Hooray 0a940763ef 修复权限未开启时菜单未过滤的问题,并简化菜单过滤逻辑 2025-06-09 23:49:23 +08:00
Hooray 2c9118e847 演示路由调整 2025-06-09 18:25:21 +08:00
Hooray 440f8d3f07 FaModal 组件 provide/inject 改为组件传参方式 2025-06-09 11:43:09 +08:00
Hooray ec5aeee854 更新依赖 2025-06-09 01:17:44 +08:00
Hooray 4af458f067 新增 FaButtonGroup 组件 2025-06-07 16:54:16 +08:00
Hooray 34f29061f8 使用 useId 优化菜单逻辑 2025-06-07 10:20:49 +08:00
Hooray ab9719727c 更新viewport设置以改善移动设备上的显示效果 2025-06-06 16:33:00 +08:00
Hooray c20738ea9c 首屏loading适配暗黑模式 2025-06-06 15:05:00 +08:00
Hooray e667db15db 增加 Vue Data UI 示例 2025-06-05 14:02:08 +08:00
Hooray 0d7317eb44 优化生成icon脚本 2025-06-04 14:09:22 +08:00
Hooray a0821be5d7 更新依赖 2025-06-03 10:47:06 +08:00
Hooray b3e5814eea 更新 Node.js 版本要求 2025-06-03 10:06:15 +08:00
Hooray 9b07c0cd64 更新依赖 2025-05-30 14:47:53 +08:00
Hooray 2f6f07dfed 修复激活标签页定位可能不居中的问题 2025-05-27 18:19:54 +08:00
Hooray e87b72f624 修复次导航收起时页面展示错误 2025-05-26 14:34:48 +08:00
Hooray 3c09401955 将 FaDropdown 组件插槽名从 label 修改为 header,并新增 footer 插槽 2025-05-21 12:01:01 +08:00
Hooray 8796f3c1cb 优化布局相关 CSS 变量处理逻辑 2025-05-15 16:04:04 +08:00
Hooray c5fa23efbe 更新依赖 2025-05-15 10:50:38 +08:00
Hooray f574c5dcf7 增加请求重试机制 2025-05-14 17:30:31 +08:00
Hooray 716eab01eb 优化菜单点击处理逻辑,增加对链接的判断 2025-05-14 14:13:57 +08:00
Hooray 8ace4fd547 新增 FaProgress 组件 2025-05-14 10:43:22 +08:00
Hooray 3cba38822c typo 2025-05-06 09:43:14 +08:00
Hooray ae5ff8f973 新增 FaHoverCard 组件 2025-05-06 03:01:10 +08:00
Hooray 34c7e41028 对未设置 redirect 的父路由,访问时将自动重定向到允许访问的子路由 2025-05-05 00:58:15 +08:00
Hooray d572e6d933 调整 ElLink 组件示例 2025-05-04 14:40:40 +08:00
Hooray 451b42b418 优化 FaScrollArea 滚动体验 2025-05-02 23:18:58 +08:00
Hooray 5412e35059 调整标签页关闭逻辑,优先跳转至前一个标签页 2025-05-01 20:09:14 +08:00
Hooray e05ae827f3 FaScrollArea 组件新增 onScroll 事件 2025-05-01 17:07:10 +08:00
Hooray a2fc0d3431 移除 QuickAdmin 2025-05-01 03:09:44 +08:00
Hooray 8156aa1ff5 代码调整 2025-04-30 15:20:59 +08:00
Hooray 824c64ae94 toast 代替 ElMessage 2025-04-30 15:08:46 +08:00
Hooray 464c495df2 更新依赖 2025-04-30 14:15:10 +08:00
Hooray 06d7479939 新增工具栏全局开关设置 2025-04-29 17:23:28 +08:00
Hooray 912d20a55c 新增预设插槽 header-after-menu、main-sidebar-after-menu 和 sub-sidebar-after-menu 2025-04-28 18:21:05 +08:00
Hooray 82c28e61f9 将账号信息按钮封装为 AccountButton 组件,并优化工具栏和导航栏的显示逻辑 2025-04-28 18:12:25 +08:00
Hooray 5ad061008b 移除 vue-office 示例 2025-04-28 17:32:51 +08:00
Hooray 5dbedd24ae 修复导航logo在禁用主页时依旧显示可点击状态 2025-04-24 15:55:43 +08:00
Hooray 55503bdb66 修复 FaDrawer 和 FaModal 组件中遗漏的 props 2025-04-12 16:36:12 +08:00
Hooray 5e1d9266e1 多个内建组件添加 defineOptions 以设置组件名称 2025-04-07 16:21:36 +08:00
Hooray 8eda175402 FileUpload 组件增加 onRemove 事件回调 2025-04-07 16:18:35 +08:00
Hooray 476cce6068 更新依赖 2025-04-04 18:51:53 +08:00
Hooray 664114b1a5 回滚移除 <Suspense> 2025-04-03 17:53:53 +08:00
Hooray bd430e2788 优化icons生成脚本 2025-04-03 14:47:25 +08:00
Hooray 25aa911556 更新依赖 2025-03-30 20:33:03 +08:00
Hooray 2f06a3ac2a 样式优化 2025-03-29 13:20:17 +08:00
Hooray 9bb68311d7 重写路由 push/go/replace 函数,移除 useTabbar 中 open/go/replace 函数 2025-03-29 01:51:48 +08:00
Hooray 2f3f374fa0 优化子菜单过渡效果,支持两套实现方案 2025-03-26 22:38:07 +08:00
Hooray 8b51977b32 增加 cursor 配置 2025-03-26 15:43:57 +08:00
Hooray 5eed494401 修改圆角系数类型为 number 2025-03-24 18:38:09 +08:00
Hooray a0c18ac7ca 新增 FaSlider 组件 2025-03-24 18:23:20 +08:00
Hooray b97cd9478b 在路由守卫中捕获异常时,添加登出逻辑 2025-03-24 14:02:32 +08:00
Hooray a35a85f6df 移除 unocss-preset-scrollbar 依赖 2025-03-24 00:04:31 +08:00
Hooray 9d20a8fbe6 layouts 布局支持 <Suspense> 2025-03-13 15:54:09 +08:00
Hooray b55ea0f61b 浏览器不支持 color-mix 时,框架主题不会同步至 element-plus 主题 2025-03-13 15:52:53 +08:00
Hooray 0440d52b17 FaCopyright 组件改用 unocss 实现样式 2025-03-12 12:41:12 +08:00
Hooray 8b9a2d0c44 修复 FaDrawer 组件 contentClass 设置无效 2025-03-12 01:22:10 +08:00
Hooray 4a0ffdd0f0 优化导航菜单 2025-03-10 21:49:36 +08:00
Hooray 49cdde285a 根据 reka-ui 调整用法 2025-03-10 17:31:34 +08:00
Hooray 7f31f86ec3 更新依赖 2025-03-10 16:35:51 +08:00
Hooray e4dad2bb42 radix-vue 迁移到 reka-ui 2025-03-10 16:08:09 +08:00
Hooray 28a532243b 面包屑导航回滚回 computed 模式 2025-03-05 10:29:49 +08:00
Hooray 1100646921 FaDivider 增加 class props 2025-03-03 23:03:04 +08:00
Hooray fabeb0d3a2 FaPageMain group 作用域 2025-03-03 23:01:28 +08:00
Hooray 39b731cf2e FaContextMenu z-index 被遮挡 2025-03-03 14:51:03 +08:00
Hooray c5f50b5686 vue-office 示例修复 2025-03-03 11:02:23 +08:00
Hooray 87ad97e5cf 更新依赖 2025-03-03 00:31:48 +08:00
Hooray 57c9d26980 调整动效 2025-03-02 10:59:59 +08:00
Hooray baa766f62a FaPopover 组件增加手动控制面板显示 2025-02-28 15:44:52 +08:00
Hooray bd764543b4 更新依赖 2025-02-28 14:10:14 +08:00
Hooray 06b62d5e8f 增加 vue devtools 启动编辑器环境变量 2025-02-27 16:26:28 +08:00
Hooray bb7ba8cfc9 更新依赖 2025-02-26 18:39:41 +08:00
Hooray 3a6c74f49a 修复 useFaModal 弹窗警告 2025-02-26 18:08:49 +08:00
Hooray 2292952d03 快捷键事件绑定/解绑迁移到各自组件中 2025-02-26 17:42:01 +08:00
Hooray 60147a7e1f 刷新按钮增加按住ctrl使用原生浏览器刷新功能 2025-02-26 17:00:45 +08:00
Hooray c59cd96fe3 优化页面刷新,刷新时禁用页面切换动画 2025-02-26 14:47:46 +08:00
Hooray 475ce3ab3d 优化删除路由中间层级对应组件的边界场景 2025-02-22 11:13:09 +08:00
Hooray 18c216390d 导航搜索面板唤起时输入框未聚焦 2025-02-22 10:44:53 +08:00
Hooray be51be6715 抽离 Copyright 组件为内建组件 2025-02-20 01:48:17 +08:00
Hooray d4e6c65247 将 BackTop 组件移动到 App.vue 2025-02-20 01:28:29 +08:00
Hooray bdae84d464 更新依赖 2025-02-18 14:33:49 +08:00
Hooray d80178c409 重构注册路由数据结构 2025-02-16 02:48:36 +08:00
Hooray 9f0bdf49b9 FaSelect 组件增加 class props 2025-02-14 18:46:56 +08:00
Hooray e76325475e FaDrawer/FaModal开启遮罩层时禁用全局滚动 2025-02-11 17:56:10 +08:00
Hooray 6ed6b87fb5 更新依赖 2025-02-07 17:11:59 +08:00
Hooray 871113e34f 优化FaDrawer/FaModal遮罩层 2025-02-05 10:04:33 +08:00
Hooray 6ed480cc2f v5.0 2025-01-24 11:44:38 +08:00
Hooray 3d993bb0b4 更新依赖 2024-12-09 11:06:47 +08:00
Hooray 570cdf9296 更新依赖 2024-12-05 10:51:19 +08:00
Hooray d70e2d523b 修复退出登录后Tab页不清除的问题 2024-11-25 18:25:01 +08:00
Hooray 952a148086 增加友情推荐 2024-11-13 18:38:04 +08:00
Hooray 553caa5307 修复文件系统路由模式下主导航高亮效果不更新 2024-11-07 23:37:21 +08:00
Hooray 30bf80a3f6 更新依赖 2024-10-18 15:19:45 +08:00
Hooray 1feea3d0c9 修复vscode无法校验css文件 2024-10-16 10:29:24 +08:00
Hooray d50b8927f6 四周年庆 2024-10-15 14:22:25 +08:00
Hooray 24d78701b0 新增友情推荐 unibest 2024-10-15 09:29:01 +08:00
Hooray e662e9a095 重构鉴权指令、鉴权组件 2024-10-08 15:18:20 +08:00
Hooray 18242685bc 优化导航菜单折叠 2024-10-08 15:18:20 +08:00
Hooray de890461f8 导航菜单动画优化 2024-10-02 00:02:30 +08:00
Hooray 8c8d612cfe 将 sass 替换为 sass-embedded 2024-09-25 17:00:56 +08:00
Hooray ecc7ed30a2 修复顶部相关布局时,移动端下工具栏不显示 2024-09-23 13:47:02 +08:00
Hooray fb7384056a 更新 tsconfig 配置 2024-09-21 13:26:06 +08:00
Hooray beab7dc1d3 更新依赖 2024-09-21 03:55:35 +08:00
Hooray 3941a53e34 修复顶部相关布局时,工具栏重复渲染 2024-09-20 23:21:11 +08:00
Hooray Hu 5fccf2136b 使用 vite-plugin-archiver 插件代替框架存档功能 2024-09-19 09:16:57 +08:00
Hooray Hu d557879395 更新依赖 2024-09-15 11:47:52 +08:00
Hooray Hu 851dff8c95 使用 vite-plugin-vue-app-loading 插件代替框架首屏loading 2024-09-13 02:08:41 +08:00
Hooray Hu 17f21b42f4 友链调整 2024-09-10 15:57:19 +08:00
Hooray Hu 97a97d8804 修改全局loading消失时机 2024-09-09 10:19:41 +08:00
Hooray Hu 5c840a6be9 优化登录相关组件 2024-09-06 01:45:01 +08:00
Hooray Hu 76336c1111 增加图片裁剪插件示例 2024-09-04 15:29:35 +08:00
Hooray Hu 8bf90c390c 优化全局loading 2024-09-03 10:24:06 +08:00
Hooray Hu 662ede640a 更新依赖 2024-09-01 19:10:56 +08:00
Hooray Hu a09d7eae95 移除 unocss 自定义 shortcuts 2024-08-28 14:00:53 +08:00
Hooray Hu ddab4a8dee 路由导航守卫移入到单独文件维护 2024-08-27 10:55:50 +08:00
Hooray Hu bec65faaab 布局相关css变量移入到布局组件中维护 2024-08-27 10:34:28 +08:00
Hooray Hu e8eb5d48e6 引入 postcss-nested 2024-08-26 23:16:47 +08:00
Hooray Hu f68e32d99b 修改百度统计代码 2024-08-22 09:18:52 +08:00
Hooray Hu 1f27a26de4 文件预览示例调整 2024-08-19 18:36:53 +08:00
Hooray Hu fa718299c1 更换域名 2024-08-19 16:02:27 +08:00
Hooray Hu 20daca1fdb 增加文件预览示例 2024-08-19 13:46:31 +08:00
Hooray Hu 4f9d806a02 SvgIcon 组件支持传入本地图片,网络图片增加载入和失败状态 2024-08-14 17:48:26 +08:00
Hooray Hu cea5c718be 修复带参路由无法记录到标签栏中 2024-08-08 16:12:08 +08:00
Hooray Hu b581cf61d2 重构登录页面 2024-08-06 02:36:14 +08:00
Hooray Hu 2219f59d5c 扩充 unocss 自定义 shortcuts 2024-08-05 14:42:27 +08:00
Hooray Hu eb663fcd02 示例调整 2024-08-03 23:07:34 +08:00
Hooray Hu 9a9db5d559 更新依赖 2024-08-03 21:59:16 +08:00
Hooray Hu f008ef429b 手动登出时不带上重定向地址 2024-07-31 15:38:07 +08:00
Hooray Hu 31ddb57fbe FileUpload 组件文件列表增加下载功能 2024-07-31 13:52:30 +08:00
Hooray Hu 28a82c6611 typo 2024-07-30 17:41:33 +08:00
Hooray Hu 7b56acd83b 代码微调 2024-07-24 17:12:18 +08:00
Hooray Hu 580fdb46be 导航菜单尺寸调整 2024-07-21 18:25:16 +08:00
Hooray Hu 9bba33213e 更新依赖 2024-07-18 11:28:26 +08:00
Hooray Hu f417cbfbe7 eslint 规则调整 2024-07-11 19:54:57 +08:00
Hooray Hu 8503c24a8a 上传组件增加自定义上传 2024-07-09 18:01:05 +08:00
Hooray Hu 51d330e514 vite插件合并到单个文件中维护 2024-07-08 16:41:07 +08:00
Hooray Hu eedeb1bc17 移除createInjectionKey函数 2024-07-05 17:42:53 +08:00
Hooray Hu cfeba93180 移除无用代码 2024-07-05 15:14:09 +08:00
Hooray Hu c36c8b321f 环境变量 VITE_APP_DISABLE_DEVTOOL 改成用 vite 插件的方式注入代码中 2024-07-03 23:25:22 +08:00
Hooray Hu 6c77443253 环境变量 VITE_APP_DEBUG_TOOL 改成用 vite 插件的方式注入代码中 2024-07-03 23:00:24 +08:00
Hooray Hu 38723aa3bc 次导航支持隐藏 2024-07-02 00:34:40 +08:00
Hooray Hu 88548360b6 更新依赖 2024-06-29 12:50:12 +08:00
Hooray Hu 1f116e79f7 HDropdownMenu 组件样式调整 2024-06-28 14:21:17 +08:00
Hooray Hu c48dea7caa 新增哀悼模式和色弱模式 2024-06-28 10:06:32 +08:00
Hooray Hu fe852477f0 增加禁用开发者工具环境变量 2024-06-26 10:42:43 +08:00
Hooray Hu fb10737c1c 修复主导航 children 为空时报错 2024-06-25 00:43:50 +08:00
Hooray Hu a5f75f9d72 配置项 menu.menuMode 变更为 menu.mode 2024-06-24 17:16:12 +08:00
Hooray Hu 0c701f35f3 修复vscode失效配置 2024-06-24 15:54:26 +08:00
Hooray Hu afa1e64276 更新依赖 2024-06-15 22:58:11 +08:00
Hooray Hu 4df17f4bf3 样式微调 2024-06-12 14:10:41 +08:00
Hooray Hu 28f835fe17 更新依赖 2024-06-07 10:30:40 +08:00
Hooray Hu 73a57bd1a4 修改 unocss 写法 2024-05-29 14:29:49 +08:00
Hooray Hu 15a069f278 优化标签栏滚动体验 2024-05-28 16:49:15 +08:00
Hooray Hu 7e3ee34ef3 更新依赖,修改 unocss 写法 2024-05-22 15:42:37 +08:00
Hooray Hu 7f7536c466 更新依赖 2024-05-20 09:58:50 +08:00
Hooray Hu 6540d74930 修复后端返回路由数据中 children 为空数组导致菜单无法正常生成 2024-05-14 10:13:34 +08:00
Hooray Hu c8559883e5 示例代码调整 2024-05-13 20:44:54 +08:00
Hooray Hu eba36e3313 增加node版本控制文件 2024-05-09 09:51:31 +08:00
Hooray Hu 074b35652d 更换链接 2024-05-07 09:52:32 +08:00
Hooray Hu 81f766cd54 更新依赖 2024-05-01 12:34:07 +08:00
Hooray Hu 0fe76d257d 调整标签页操作按钮点击区域 2024-04-29 17:50:43 +08:00
Hooray Hu c1c6ca1376 增加 vchart 演示 2024-04-26 23:42:53 +08:00
Hooray Hu d38e405c6a 登录页增加扫码登录参考 2024-04-26 11:27:02 +08:00
Hooray Hu c4ebcfcf9c 更新 github 工作流 2024-04-24 17:24:40 +08:00
Hooray Hu e122ca4739 移除无用代码 2024-04-24 17:24:15 +08:00
Hooray Hu f0ddac0a94 修复类型定义 2024-04-23 10:26:52 +08:00
Hooray Hu 425fed358f 标签栏解绑错误快捷键 2024-04-15 09:51:23 +08:00
Hooray Hu 458abe0679 更新 any-rule 正则 2024-04-12 21:39:15 +08:00
Hooray Hu ba3e3273e4 明暗图标替换 2024-04-09 17:20:33 +08:00
Hooray Hu a861646d76 标签栏右键菜单自定义样式没在指定 class 范围内生效 2024-04-09 16:55:52 +08:00
Hooray Hu 3210178aa3 路由 meta.auth 保持元信息默认合并行为,路由访问改为通过 route.matched 进行逐级鉴权 2024-04-09 15:13:32 +08:00
Hooray Hu afe7b2e442 修复一级路由设置 meta.menu: false 无效 2024-04-05 14:44:01 +08:00
Hooray Hu dde17d4d68 更新依赖 2024-03-31 22:51:24 +08:00
Hooray Hu 53cd5dab02 移除活动信息 2024-03-31 01:32:51 +08:00
Hooray Hu 093a7923a1 文件路由系统下,用户权限变化后,菜单不更新 2024-03-28 21:59:11 +08:00
Hooray Hu ebf59fda22 移除routeStore.routes 2024-03-28 16:38:08 +08:00
Hooray Hu e983de6acf menuStore.menus 转为内部使用,外部统一使用 menuStore.allMenus 2024-03-28 13:48:20 +08:00
Hooray Hu 5b85bdd953 页面宽度判断移动端设备从992调整为1024 2024-03-28 09:22:35 +08:00
Hooray Hu e9d7970f9f 增加 vue hooks plus 插件示例 2024-03-26 14:42:45 +08:00
Hooray Hu 5b01a1f9dc 更新依赖 2024-03-21 14:47:38 +08:00
Hooray Hu f48ebec022 修复后端返回路由时,因为父级auth为空字符串或数组导致子级权限失效的问题 2024-03-19 22:32:55 +08:00
Hooray Hu 10fae3fde1 修改 github actions 2024-03-18 02:14:12 +08:00
Hooray Hu 7bc6fa4feb 修复顶部导航数量过多,导致工具栏被遮挡 2024-03-18 00:31:01 +08:00
Hooray Hu a6ed0a5455 修复顶部导航鼠标滚动回弹 2024-03-18 00:27:16 +08:00
Hooray Hu 864f996e99 路由增加 meta.menu 配置,同时 meta.sidebar 进入弃用过渡期 2024-03-17 00:12:48 +08:00
Hooray Hu c96eb69f3b 更新依赖 2024-03-14 11:55:18 +08:00
Hooray Hu 15cb0a59b3 修改 tinymce 安装说明 2024-03-09 14:26:32 +08:00
Hooray Hu 1825cea40f 更新活动信息 2024-03-07 11:21:24 +08:00
Hooray Hu bbac5c7ecf 修复 mock 模板请求无响应数据 2024-03-07 09:22:48 +08:00
Hooray Hu 80235a16fb 调整 onsize 事件写法 2024-03-05 09:27:37 +08:00
Hooray Hu 006cf16f41 修改 workflow 2024-03-04 09:23:10 +08:00
Hooray Hu 0a36ae78e5 移除弃用扩展 2024-03-04 09:08:23 +08:00
Hooray Hu 1345010686 增加最低 node 版本限制 2024-02-29 14:14:35 +08:00
Hooray Hu dc4371d55a 更新 workflows 2024-02-28 10:35:16 +08:00
Hooray Hu 641f502473 用户态改回用 localStorage 存储 2024-02-26 15:16:17 +08:00
Hooray Hu ba9b33b4a4 更新依赖 2024-02-26 13:57:36 +08:00
Hooray Hu 623e32ea23 修复类型报错 2024-02-25 16:47:18 +08:00
Hooray Hu 1c865a0a2f 更新依赖 2024-02-25 16:37:10 +08:00
Hooray Hu 683bc49c23 调整友情推荐 2024-02-25 16:35:14 +08:00
Hooray Hu 86a70d6632 增加 vue-currency-input 插件示例 2024-02-21 13:52:34 +08:00
Hooray Hu 15cfb9fb23 修改登录相关数据 2024-02-12 23:59:05 +08:00
Hooray Hu 57ccc553fb 更新依赖 2024-02-11 21:06:18 +08:00
Hooray Hu f5e6c1a83b 更新依赖 2024-02-04 14:43:33 +08:00
Hooray Hu dc9ce837af 修复标签栏未开启时调用 useTabbar 内函数报错 2024-02-01 11:32:25 +08:00
Hooray Hu a086dde98e 样式调整 2024-01-31 17:00:26 +08:00
Hooray Hu 4eeb6d45c8 vite-plugin-vue-devtools 替换 vite-plugin-vue-inspector 2024-01-30 17:08:51 +08:00
Hooray Hu 863a362e89 代码微调 2024-01-30 01:16:56 +08:00
Hooray Hu d89d67e434 增加标签页演示页面 2024-01-30 01:16:27 +08:00
Hooray Hu 7f0d841130 明暗模式设置为跟随系统时,支持动态切换 2024-01-27 10:39:51 +08:00
Hooray Hu 2a3700fc54 修复顶部模式下页面载入进度条被遮挡 2024-01-26 15:45:06 +08:00
Hooray Hu 95a1b28b5a 导航菜单收起时,无二级的一级导航增加 tooltip 展示 2024-01-26 00:59:03 +08:00
Hooray Hu 700608460e 优惠信息调整 2024-01-25 22:49:38 +08:00
Hooray Hu ad03d7db53 更新依赖 2024-01-25 09:41:28 +08:00
Hooray Hu 380b9cccd8 增加标签页支持 2024-01-25 09:32:06 +08:00
Hooray Hu 86a6fb5173 增加图片支持,整站图标改用 unocss icon 方式使用,方便在内网环境使用 2024-01-18 00:30:59 +08:00
Hooray Hu 3210b80a4d 增加打包后生成存档文件支持 2024-01-14 00:11:09 +08:00
Hooray Hu 2e34d88d94 vite-plugin-compression2 替换 vite-plugin-compression 2024-01-14 00:08:44 +08:00
Hooray Hu 738c74d1c4 增加运行时信息 2024-01-14 00:06:09 +08:00
Hooray Hu fb540ebef9 引入 unplugin-turbo-console 优化开发体验 2024-01-12 10:44:47 +08:00
Hooray Hu 4ebba1f54e 更新依赖 2024-01-11 10:50:58 +08:00
Hooray Hu dc4f4e1d3a 修复导航模式切换到 single 时有几率报错 2024-01-08 10:59:57 +08:00
Hooray Hu 81d2b12515 用 defineModel 重构部分组件 2024-01-07 00:23:00 +08:00
Hooray Hu 07c8a48386 更新依赖 2024-01-06 21:24:30 +08:00
Hooray Hu a08f6efd86 优化 HDropdown / HDropdownMenu / HTooltip 组件触发隐藏逻辑 2024-01-06 11:24:28 +08:00
Hooray Hu d58f359c19 mock 数据修复 2024-01-05 00:48:59 +08:00
Hooray Hu 0cd1a5f8b6 移除无用样式 2024-01-04 22:59:39 +08:00
Hooray Hu 19b881d526 修复工具栏显示/隐藏逻辑 2024-01-04 22:58:30 +08:00
Hooray Hu 2e68444755 样式微调 2024-01-04 11:21:08 +08:00
Hooray Hu c59c5017a4 vite-plugin-fake-server 替换 vite-plugin-mock 2024-01-04 01:15:10 +08:00
Hooray Hu 15ed4a6063 修复次导航高度变化时,底部阴影不变化 2024-01-02 02:06:07 +08:00
Hooray Hu 6420fc1d66 次导航展开收起按钮位置移动到次导航底部 2024-01-02 01:15:14 +08:00
Hooray Hu 3b9f68828f 修复 FixedActionBar 组件阴影样式未生效 2024-01-02 00:28:05 +08:00
Hooray Hu 49f0baba92 更新依赖 2024-01-01 01:15:42 +08:00
Hooray Hu 4af1e44b51 工具栏文件目录结构调整 2023-12-30 15:42:26 +08:00
Hooray Hu f0fc82fd7a 应用配置 toolbar 对象内属性调整 2023-12-28 21:55:16 +08:00
Hooray Hu bbd314e042 修复路由 HTML5 模式下点击导航刷新页面的问题 2023-12-26 15:51:56 +08:00
Hooray Hu e1cff24d34 更新依赖 2023-12-24 00:21:02 +08:00
Hooray Hu f8d69f35f0 更新依赖,更新stylelint配置 2023-12-22 16:44:41 +08:00
Hooray Hu 14633772d5 更新依赖 2023-12-21 00:04:33 +08:00
Hooray Hu be4cb14a9a 应用配置 app.enableAppSetting 迁移到环境变量文件中 2023-12-18 00:14:18 +08:00
Hooray Hu b8b18a8d83 优化 UI 组件库的配置和使用方式 2023-12-17 02:54:19 +08:00
Hooray Hu 248c81c973 更新依赖 2023-12-16 00:52:56 +08:00
Hooray Hu 4a9e95827c 更新合作伙伴及演示地址 2023-12-14 23:38:31 +08:00
Hooray Hu a9a2704ae1 应用配置增加 home.fullPath 2023-12-14 21:43:07 +08:00
Hooray Hu f1c31a2fc2 优化应用配置复制功能 2023-12-12 01:02:50 +08:00
Hooray Hu 470e26ab52 导航栏设置激活状态逻辑优化 2023-12-10 03:31:31 +08:00
Hooray Hu cb85fe4e3b 最子级菜单项用 <a> 渲染 2023-12-08 15:01:13 +08:00
Hooray Hu eda549025c 更新 vscode 配置 2023-12-08 09:39:45 +08:00
Hooray Hu ae393104e0 更新依赖 2023-12-07 14:10:17 +08:00
Hooray Hu 52c7d2d300 主页样式微调 2023-12-07 09:04:59 +08:00
Hooray Hu e06387be2a 更新依赖 2023-12-04 00:37:39 +08:00
Hooray Hu 759319dbdc 更新依赖 2023-11-29 14:48:33 +08:00
Hooray Hu 73bd98e0f4 修复次导航的显隐逻辑 2023-11-29 14:07:10 +08:00
Hooray Hu 9e3797c05c 更新依赖,eslint 增加 unocss 配置 2023-11-28 16:00:04 +08:00
Hooray Hu f31c69a557 修改 SearchBar 组件示例 2023-11-28 10:51:29 +08:00
Hooray Hu 648560c308 更新依赖 2023-11-25 23:19:50 +08:00
Hooray Hu bbb747beb8 eslint 规则替换 2023-11-21 17:05:12 +08:00
Hooray Hu 281d99fa54 登录页logo图替换为img标签 2023-11-21 15:50:47 +08:00
Hooray Hu 7c574a3897 导航title类型补充 2023-11-21 14:26:49 +08:00
Hooray Hu d8add2f6d8 修复次导航第一个导航无子级路由时不显示 2023-11-21 11:37:01 +08:00
Hooray Hu ad12376037 调整导航顶部模式下展示样式 2023-11-20 15:10:46 +08:00
Hooray Hu ae07789d4f 更新依赖 2023-11-20 09:46:43 +08:00
Hooray Hu a079b0236f 搜索界面弹出时动画失效 2023-11-17 00:28:36 +08:00
Hooray Hu bb135be01a 修复文件系统路由下,导航栏无法展开多级和一级导航无法点击 2023-11-15 00:13:38 +08:00
Hooray Hu 41aca36bd7 更新依赖 2023-11-10 10:48:02 +08:00
Hooray Hu ffbd9907a2 修复 vue-esign 插件示例未显示 2023-11-09 11:15:08 +08:00
Hooray Hu 8c9fe3b2ff 合作伙伴增加 form-create 2023-11-08 19:20:43 +08:00
Hooray Hu 66797558c7 更新依赖 2023-11-05 12:11:40 +08:00
Hooray Hu 28264a8790 增加 Vexip UI 示例链接 2023-11-03 23:47:11 +08:00
Hooray Hu d489b035d6 生态增加 Vexip UI 链接 2023-11-03 22:50:10 +08:00
Hooray Hu 0e752033f2 调整 HDialog / HSlideover 组件 overlay 属性默认为 false 2023-11-03 22:46:18 +08:00
Hooray Hu 548f1ed2f3 移除 Copyright 组件无效样式 2023-11-03 22:40:54 +08:00
Hooray Hu e7cfe9170b 修复 plop 无法使用 2023-10-31 20:57:22 +08:00
Hooray Hu e670ddddd9 修复导航跳转时如果被中断,高亮位置不正确 2023-10-31 16:07:43 +08:00
Hooray Hu 89ed9f6a27 修复 HTabList 组件文字不居中的问题 2023-10-31 10:01:46 +08:00
Hooray Hu 72373eb793 更新依赖 2023-10-30 14:51:34 +08:00
Hooray Hu 6354902950 修复火狐下样式兼容性问题 2023-10-30 14:47:14 +08:00
Hooray Hu 807e3f9402 v4.0 2023-10-29 23:00:06 +08:00
Hooray Hu 8dd088de9d 更新依赖 2023-10-25 23:06:14 +08:00
Hooray Hu b354f7d59c 更新依赖 2023-10-17 09:37:11 +08:00
Hooray Hu 4cd7386646 修复搜索结果列表图标展示过大 2023-10-11 17:20:37 +08:00
Hooray Hu 1fb946a678 更新依赖 2023-10-10 09:09:22 +08:00
Hooray Hu 7c40a235ce 修复 403/404 页面图标尺寸 2023-09-26 15:13:39 +08:00
Hooray Hu ef5cbcd32f 修复后端返回路由 component 字段为空导致link导航失效 2023-09-15 00:21:49 +08:00
Hooray Hu b7de39d877 开发环境默认关闭本地代理 2023-09-09 09:36:04 +08:00
Hooray Hu 8b8b780d33 更新依赖 2023-08-26 12:18:11 +08:00
Hooray Hu 4e30569d5c 补充 process 引入 2023-08-26 12:17:42 +08:00
Hooray Hu 436f6308b0 plop 模板读取增加校验 2023-07-29 10:17:09 +08:00
Hooray Hu aa8e12c5c7 更新依赖,修改 ts 警告 2023-07-29 10:15:20 +08:00
Hooray Hu c5c66c99eb 更新依赖 2023-07-04 15:29:02 +08:00
Hooray Hu 516a582845 更新工作流 2023-07-04 15:17:55 +08:00
Hooray Hu d95d363af9 更新依赖 2023-06-22 17:21:45 +08:00
Hooray Hu bcb9f04566 修复mock数据 2023-06-20 11:39:38 +08:00
Hooray Hu b3ada7a5d1 更新任务流 2023-06-14 16:13:17 +08:00
Hooray Hu c3cc59ed4e 更新依赖 2023-06-12 21:46:30 +08:00
Hooray Hu 05e1da7678 eventBus 类型完善 2023-06-05 20:26:33 +08:00
Hooray Hu 870f25b5c7 更新 github actions 2023-06-04 22:08:13 +08:00
Hooray Hu 833c314afd 更新百度统计 2023-06-04 21:27:00 +08:00
Hooray Hu 97d6112582 移除 el-icon 使用 2023-06-03 17:24:01 +08:00
Hooray Hu afa46bf747 copyright 组件移动到 layouts 目录下 2023-06-02 00:27:34 +08:00
Hooray Hu 33bef7bd93 优化 plop 启动脚本,自动读取模版目录 2023-06-01 23:46:17 +08:00
Hooray Hu 0e55453f3d 代码微调 2023-06-01 23:34:58 +08:00
Hooray Hu b228a9540a 修改网址 2023-05-30 21:40:52 +08:00
Hooray Hu 9f38ff6e20 更新活动信息 2023-05-27 04:03:35 +08:00
Hooray Hu d0eeb0fdb3 调整 copyright 默认设置 2023-05-27 01:51:44 +08:00
Hooray Hu 4f489c91d4 代码微调 2023-05-24 10:58:02 +08:00
Hooray Hu ef5e2fe76c 使用 defineOptions 设置组件 name 2023-05-24 10:57:00 +08:00
Hooray Hu 859ceac472 统一调整 defineEmits 写法 2023-05-23 23:14:58 +08:00
Hooray Hu 107a0b5a1b 更新依赖 2023-05-23 23:06:41 +08:00
Hooray Hu 01b4da8480 移除模板代码中的 $route 2023-05-13 01:58:57 +08:00
Hooray Hu 5ff0aba078 调整 <script setup> 属性顺序 2023-05-13 00:42:47 +08:00
Hooray Hu f59151289f 统一调整 defineProps 以及默认值的写法 2023-05-13 00:35:32 +08:00
Hooray Hu c2e1b97e5a 使用 defineOptions 设置组件 name 2023-05-13 00:13:32 +08:00
Hooray Hu e011ba2fd2 更新依赖 2023-05-11 22:33:52 +08:00
Hooray Hu c0db5b97b2 引入vite legacy插件 2023-05-10 11:03:33 +08:00
Hooray Hu 8c9fbc542b 更新依赖 2023-05-08 09:01:36 +08:00
Hooray Hu 136d2cf216 重构次导航默认展开效果 2023-05-06 16:16:42 +08:00
Hooray Hu 2ffc8fe59d 修改mock请求地址 2023-05-06 13:40:07 +08:00
Hooray Hu 31bb047dac 主页排版调整 2023-05-05 23:49:37 +08:00
Hooray Hu d4f7261882 SearchBar 组件示例调整 2023-05-05 23:46:01 +08:00
Hooray Hu a632405423 优化 PageHeader 组件样式 2023-05-05 23:38:08 +08:00
Hooray Hu 8c5af5d8e0 更新依赖 2023-05-02 02:24:11 +08:00
Hooray Hu b7ba455ca7 入口 index.html 设置为不缓存 2023-04-26 23:03:23 +08:00
Hooray Hu b56258e209 更新依赖 2023-04-26 23:01:36 +08:00
Hooray Hu 250c2fb7f6 修改 hidden 类名,避免和 unocss 产生冲突 2023-04-26 16:12:55 +08:00
Hooray Hu 394694bc4c 修复主页无法引入请求 api 并使用的问题 2023-04-25 00:37:46 +08:00
Hooray Hu 2b205bf5bd 更新依赖 2023-04-22 02:38:29 +08:00
Hooray Hu 0ba65db768 移除 BatchActionBar 组件 2023-04-22 01:24:03 +08:00
Hooray Hu 97edf77ab7 重构接口请求,统一管理接口请求模块 2023-04-22 01:08:02 +08:00
Hooray Hu f0b1551530 重构 SearchBar 组件 2023-04-19 16:36:25 +08:00
Hooray Hu a6c46ea7d4 vite-plugin-vue-setup-extend 替换为 unplugin-vue-setup-extend-plus 2023-04-14 15:43:33 +08:00
Hooray Hu 58892d4994 更新依赖 2023-04-13 15:43:53 +08:00
Hooray Hu fffadc5f4f 调整应用配置的配置项,并将应用配置按钮从工具栏删除 2023-04-12 13:46:58 +08:00
Hooray Hu 58d4a56663 优化登录 mock ,通过请求头里的 token 信息判断用户 2023-04-12 00:16:24 +08:00
Hooray Hu c74f435bc6 引入 stylelint-stylistic 插件 2023-04-10 02:28:06 +08:00
Hooray Hu 5a245fb819 vite-plugin-vue-layouts 替换为 vite-plugin-vue-meta-layouts 2023-04-06 01:16:04 +08:00
Hooray Hu 429df53573 调整代码风格 2023-04-06 00:04:23 +08:00
Hooray Hu 31b07f887d 更新依赖 2023-04-05 23:59:38 +08:00
Hooray aa08ee93ab 移除Editor组件及演示 2023-04-01 14:37:20 +08:00
Hooray b6e47b6f6d 更新依赖,修改lint配置 2023-03-28 01:14:35 +08:00
Hooray a83a8213e1 使用 Vite 新特性将入口 html 页面里的 title 用环境变量替换 2023-03-25 11:56:19 +08:00
Hooray 8d43865e84 修改 hidden 类名 2023-03-22 16:53:40 +08:00
Hooray 591a2fe4b8 更新依赖 2023-03-22 16:51:02 +08:00
Hooray 1c842c9ac5 更新依赖 2023-03-10 23:55:05 +08:00
Hooray 04ea69db9d 代码微调 2023-03-08 20:45:33 +08:00
Hooray 639868dc8b 调整基础组件演示页面 2023-03-07 23:23:17 +08:00
hooray 1b0389c1b5 修复 axios baseURL 配置,解决构建后 baseURL 不生效的问题 2023-03-06 16:26:00 +08:00
hooray 07932329a0 移除响应性语法糖功能,该实验性功能已被废弃 2023-03-06 14:52:03 +08:00
Hooray a2173b3137 用户权限变更后,自动更新导航菜单和页面权限,无需刷新页面或者重新登录 2023-03-05 18:02:21 +08:00
Hooray c34a2a623e 更新依赖 2023-03-05 15:29:59 +08:00
hooray db750d9289 调整权限演示页面 2023-02-27 11:34:38 +08:00
Hooray 6feafeb2d5 调整优惠信息 2023-02-26 16:20:52 +08:00
Hooray 49d9e5eb2d 优化无权限路由的过滤函数 2023-02-25 19:06:42 +08:00
Hooray 9e723d44df 更新依赖 2023-02-25 12:16:06 +08:00
Hooray 9583aae73b 自动生成页面模板增加基于文件系统路由的配置项 2023-02-25 12:07:51 +08:00
Hooray 8516f9f974 调整eslint规则 2023-02-25 12:05:45 +08:00
Hooray 894199b61e 压缩svg文件 2023-02-25 11:02:17 +08:00
Hooray e896f301d2 增加403无权限页面 2023-02-25 10:58:21 +08:00
Hooray fb129e83a2 修复登录页标题未正常显示 2023-02-23 22:30:52 +08:00
hooray c253ef6fb4 修复路由meta.auth设置为''/[]时,权限判断为无权限的问题 2023-02-22 21:01:54 +08:00
hooray 108073b6e1 移除 vite-plugin-html 插件 2023-02-22 19:16:50 +08:00
Hooray 2ab04b1fdf 更新依赖 2023-02-20 01:56:45 +08:00
Hooray b6ed4a3f69 优化mac系统下快捷键键位展示 2023-02-18 22:19:39 +08:00
hooray 85d8824bb6 更新依赖,移除 stylelint 废弃规则 2023-02-13 17:37:13 +08:00
hooray 214d073361 更新依赖 2023-02-11 21:31:07 +08:00
hooray 9f77082a99 解决eslint警告 2023-02-02 14:47:51 +08:00
hooray 2745dcf447 更新依赖 2023-02-02 14:47:32 +08:00
hooray 3f4e9f1020 更新依赖 2023-01-31 15:19:34 +08:00
hooray 68a62adca6 更新依赖 2023-01-15 12:18:45 +08:00
hooray ea80e01c50 修复面包屑导航显示bug 2023-01-15 12:17:31 +08:00
hooray 82018a1ecb 更新优惠活动 2023-01-09 16:43:18 +08:00
hooray f1e34ce39a 更新依赖 2023-01-09 10:22:10 +08:00
hooray a48ae3f16a 部署测试 2023-01-07 11:26:18 +08:00
hooray 846f8e58f2 更新默认 copyright 信息 2023-01-03 11:24:26 +08:00
hooray 1a55efd4e5 更新依赖 2022-12-28 12:55:26 +08:00
hooray cabd25636a 修复次导航收起时图标不居中 2022-12-22 12:01:00 +08:00
hooray ff43003921 更新依赖 2022-12-22 11:55:25 +08:00
hooray a841910406 修复预览图片无法完整覆盖 el-table 固定列 2022-12-19 22:15:11 +08:00
hooray 73152a00ef 引入 vite-plugin-vue-inspector 插件 2022-12-19 20:43:18 +08:00
hooray 4523624cb0 修复应用配置中复制配置按钮,复制内容过多的问题 2022-12-18 18:50:52 +08:00
hooray a6e33aeec1 移除环境配置文件里无效配置 2022-12-15 22:33:50 +08:00
hooray ff29d5b20a 修改 vite 构建配置 2022-12-14 00:10:03 +08:00
hooray 72d5dcb8c6 修改 vite 构建配置,兼容 github pages 2022-12-13 23:44:16 +08:00
hooray c4f14ec849 更新依赖 2022-12-13 22:29:49 +08:00
hooray 376ae390b2 pinia store 改为 setup 写法 2022-12-13 22:25:57 +08:00
hooray e2aa5480cd 更新依赖 2022-12-10 16:59:02 +08:00
hooray daf4efe963 优化搜索界面布局样式 2022-12-10 16:57:49 +08:00
hooray cd77d1850e 给 /src/types/ 路径增加 # alias 2022-12-09 00:58:45 +08:00
hooray 67bed03411 将类型定义 d.ts 文件统一存放到 /src/types/ 目录下 2022-12-08 02:31:00 +08:00
hooray c9f7cdc5c3 修复导航栏a标签href异常 2022-12-07 12:02:17 +08:00
hooray 99616f3edc 调整全局搜索快捷键说明文字因背景导致显示不清晰 2022-12-06 21:27:57 +08:00
hooray 7339d50d94 优化遮罩层样式 2022-12-05 00:36:34 +08:00
hooray f0a46d6ca1 顶栏增加粘性模式 2022-12-04 23:11:24 +08:00
hooray 6dfe35d6b7 改用 element plus 原生 api 实现密码输入框显示密码功能 2022-12-04 03:57:37 +08:00
hooray 1c5cef936e 更新依赖 2022-12-03 16:00:32 +08:00
hooray 68f45dd7dc 增加外链路由跳转提示页面,重构外链路由的配置方式 2022-12-01 20:11:56 +08:00
hooray 7a3ff65b05 代码微调 2022-11-30 04:09:26 +08:00
hooray 7e5911d0e0 修复 eslint 警告 2022-11-30 03:59:01 +08:00
hooray f19110725e 更新依赖 2022-11-30 02:07:34 +08:00
hooray 6a97837cd6 修改 Menu.recordRaw 和 Menu.recordMainRaw 类型里的 meta 为可选参数 2022-11-27 23:39:54 +08:00
hooray 68116da966 修复标题显示异常 2022-11-27 23:36:20 +08:00
hooray c0a13151a4 移除自定义 Route.recordRaw 类型,改用 RouteRecordRaw 类型 2022-11-27 17:50:06 +08:00
hooray 3941ebdb40 修复文件系统路由模式下,全局搜索列表 icon 显示不全 2022-11-27 04:09:09 +08:00
hooray 363f3e83b7 路由meta.title修改为非必须 2022-11-27 03:51:54 +08:00
hooray 7281bc5679 更新依赖 2022-11-26 09:41:14 +08:00
hooray 63133acc77 更新依赖 2022-11-19 21:35:28 +08:00
hooray d60a5f8674 修复文件系统路由下,次导航无法按层级依次展开 2022-11-19 09:29:47 +08:00
hooray 9d2bf27936 控制台修改为主页,路由调整为根路由 2022-11-19 09:29:27 +08:00
hooray 34270f1f5c 优化 PageHeader 组件在移动端下的展示 2022-11-13 00:50:43 +08:00
hooray ba642ab075 更新依赖 2022-11-10 19:52:09 +08:00
hooray 9bd4a57cad husky 替换为 simple-git-hooks 2022-11-09 16:04:56 +08:00
hooray f85b937234 更新依赖 2022-11-08 00:36:24 +08:00
hooray d98cdf2b9b logo 支持非正方形图片 2022-11-04 17:23:56 +08:00
hooray 90746aa9d5 更新依赖 2022-10-29 18:42:55 +08:00
hooray 2da911fb50 更新依赖 2022-10-25 08:32:56 +08:00
hooray dde3407fb0 调整 copyright 信息和展示逻辑 2022-10-25 08:26:55 +08:00
hooray 73a40ebd74 移除 vite-plugin-restart 2022-10-25 08:24:41 +08:00
hooray 101474dfad 优化配置项合并 2022-10-25 08:23:03 +08:00
hooray 21477cf630 useCurrentInstance() 重命名为 useGlobalProperties() 2022-10-23 14:23:43 +08:00
hooray ebf0ceeb90 调整 github action 构建 2022-10-23 14:19:09 +08:00
hooray 08bef75035 将 element plus 反馈组件改为手动引入 2022-10-23 14:17:15 +08:00
hooray a17c531340 给 eslint 和 stylelint 命令增加 --cache 设置 2022-10-23 14:04:42 +08:00
hooray 3e6511f0e8 重建 pnpm-lock.yaml 文件 2022-10-23 14:02:53 +08:00
hooray ba6e35bbb3 更新依赖 2022-10-23 13:59:28 +08:00
hooray b2abbf1ff1 增加 vscode 推荐扩展 2022-10-22 00:51:06 +08:00
hooray f84b719e22 增加 vue-tsc 校验脚本 2022-10-21 03:58:48 +08:00
hooray e1f58537d5 修复类型报错 2022-10-16 07:11:30 +08:00
hooray ad26aec066 优化拦截器 2022-10-16 06:48:26 +08:00
hooray 2ab995d8c9 更新依赖 2022-10-16 05:59:51 +08:00
hooray 5e2c3079fc 更新 tinymce 主题样式和汉化文件 2022-10-16 05:58:52 +08:00
hooray 09476108c5 更新依赖 2022-10-14 18:43:49 +08:00
hooray ded2606d17 回退部分定位组件的 z-index 设置,强制重写 v-loading 的 z-index 样式 2022-10-13 19:18:39 +08:00
hooray 18cee4fcd5 调整部分定位组件的z-index层级 2022-10-13 14:21:13 +08:00
hooray aec2ea5574 路由导航守卫代码注释调整 2022-10-13 14:18:51 +08:00
hooray 240bfed070 优化代码逻辑 2022-10-13 14:14:57 +08:00
hooray 76a8e16958 更新依赖 2022-10-13 14:11:45 +08:00
hooray 77353ec8c6 优化构建 2022-10-12 01:37:55 +08:00
hooray 371ba26f51 调整文件忽略 2022-10-12 01:34:50 +08:00
hooray 9eb5d3e6f7 修复获取侧边栏导航最深一级路由可能返回为空的问题 2022-10-12 01:30:16 +08:00
hooray 1ca406c475 简化导航守卫里的逻辑 2022-10-12 01:29:03 +08:00
hooray 68ee500d67 优化构建 2022-10-12 01:25:42 +08:00
hooray 67783fc6b7 优化构建 2022-10-12 01:19:37 +08:00
hooray ee78a80307 更新依赖 2022-10-10 23:38:34 +08:00
Hooray a004108702 更新依赖 2022-10-09 02:38:02 +08:00
Hooray 78819f9420 更新 stylelint 规则 2022-10-03 22:11:54 +08:00
Hooray 4ec678f71f 控制语句代码风格调整 2022-10-02 03:29:49 +08:00
Hooray 340436d757 优化文件生成模版 2022-09-29 22:04:39 +08:00
Hooray 715d96f823 更新依赖 2022-09-29 21:55:38 +08:00
hooray 3a196d6809 修复mock文件引入后缀错误 2022-09-26 00:28:19 +08:00
hooray 03a10f569c 修改演示配置 2022-09-26 00:18:23 +08:00
hooray 83d993321f 修改演示配置 2022-09-26 00:09:49 +08:00
hooray 4fe1a52d23 修改演示配置 2022-09-26 00:05:06 +08:00
hooray 22e8192b58 TypeScript 支持 2022-09-25 23:32:45 +08:00
hooray bedd986d45 更新依赖 2022-09-16 01:47:39 +08:00
Hooray 7308a43c5f 更新依赖 2022-09-04 21:04:54 +08:00
hooray faaf93ffc8 更新依赖 2022-08-29 15:36:10 +08:00
hooray 1ac149adae 优化顶部导航滚动 2022-08-21 16:34:33 +08:00
hooray 91e0c17b2f 优化导航顶部模式下的展示 2022-08-20 16:37:23 +08:00
hooray e3ae303a46 更新依赖 2022-08-19 20:50:58 +08:00
hooray 4b2ff7d52c 优化 FileUpload 组件 2022-08-14 18:33:40 +08:00
hooray 453ed1447b 更新依赖 2022-08-14 18:18:19 +08:00
hooray 9f6c7847ed 修改样式文件目录结构,优化 element plus 样式载入 2022-08-14 18:15:24 +08:00
hooray 820a62c0f9 更新演示 2022-08-10 20:07:24 +08:00
hooray 1b9158f5b9 更新演示 2022-08-10 19:49:10 +08:00
hooray e39b90c625 优化 FileUpload 组件 2022-08-10 17:45:24 +08:00
hooray 5de8e48764 修复编辑器默认图片上传 bug 2022-08-10 12:08:07 +08:00
hooray a1b62e52de 更新依赖 2022-08-09 22:35:36 +08:00
hooray 5a505ef876 CascaderArea 组件升级为 PcasCascader 组件 2022-08-07 04:02:14 +08:00
hooray 63fa2d1862 更新合作伙伴 2022-07-31 15:50:10 +08:00
hooray a93fc433f6 修改演示 2022-07-30 19:24:17 +08:00
hooray 421a8e0612 调整目录结构 2022-07-30 01:37:40 +08:00
hooray 80182c54c3 移除全局属性 2022-07-30 00:39:05 +08:00
hooray 03b10947a6 代码微调 2022-07-30 00:12:56 +08:00
hooray 326b7c331d 更新依赖 2022-07-28 14:12:14 +08:00
hooray 0a373796fc 修复 FileUpload 组件 headers 参数未使用的问题 2022-07-28 14:07:26 +08:00
hooray 7ca0bdb4a4 优化登录页banner展示 2022-07-20 11:35:20 +08:00
hooray 21d0b2ea63 更新依赖 2022-07-11 18:24:06 +08:00
hooray 65aa3b2594 修复登出后 F5 刷新失效的问题 2022-07-11 18:22:28 +08:00
hooray bfc35babbc 修复面包屑导航展示bug 2022-07-08 03:37:23 +08:00
hooray 304f0aa39a 代码优化 2022-07-06 00:38:02 +08:00
hooray 4ca42b1cf1 更新依赖 2022-07-03 02:52:09 +08:00
Hooray 4df4b5a8da 代码优化 2022-07-01 18:02:50 +08:00
Hooray 00a01c6cb4 更新依赖 2022-07-01 14:50:05 +08:00
Hooray fced35267b 更新依赖 2022-06-30 10:37:32 +08:00
Hooray 25e0b1f7fc 修改 github action 2022-06-27 10:03:35 +08:00
hooray 4a306a47b8 导航调整 2022-06-24 00:26:43 +08:00
hooray dd530fa5f8 优化导航守卫路由动态注册,将404页面修改为固定路由 2022-06-24 00:11:31 +08:00
hooray 910dcaa060 调整文件系统路由下页面刷新效果 2022-06-24 00:01:34 +08:00
hooray b545ea7c66 代码调整 2022-06-22 20:27:50 +08:00
Hooray 4e4e757d5f 更新代码 2022-06-22 17:32:42 +08:00
Hooray 649f97292e 代码调整 2022-06-22 17:25:41 +08:00
hooray 6da5e87cd3 代码调整 2022-06-21 22:48:29 +08:00
hooray abcc1203e6 代码调整 2022-06-21 22:39:31 +08:00
Hooray f0167313a7 tinymce 更新到 6.x 2022-06-21 14:32:54 +08:00
hooray f730295b35 PageMain 组件增加 title slot 设置 2022-06-19 20:55:32 +08:00
hooray e9d7f88be2 优化全局搜索组件,移除 teleport 特性 2022-06-18 23:08:38 +08:00
hooray c55d690cff 更新依赖 2022-06-18 23:06:54 +08:00
Hooray 11c5062c21 移除 github action 2022-06-16 15:01:39 +08:00
hooray 795b8b6899 移除 keep-alive 组件延迟设置 include 参数无效的 hack 写法 2022-06-15 21:02:44 +08:00
Hooray 36b3c926db 修复面包屑导航无法显示一级导航的问题 2022-06-14 18:18:45 +08:00
hooray 1a3412c001 底部版权增加备案号设置 2022-06-12 16:54:55 +08:00
hooray 5a2ffe8bc1 优化 el-drawer 组件使用 2022-06-11 12:31:26 +08:00
hooray 859d0be44c 更新依赖 2022-06-10 01:23:42 +08:00
hooray 9c13fc8fb5 优化pinia使用 2022-06-08 01:44:55 +08:00
Hooray 21597d27bd 替换 jsdelivr 地址 2022-06-07 09:51:50 +08:00
hooray 6f5d381a08 更新控制台相关链接 2022-06-06 01:40:44 +08:00
hooray 0f9e4edc68 修改github action 2022-06-05 18:25:45 +08:00
hooray e3f7bee75b 更新github action 2022-06-05 01:43:24 +08:00
hooray 115cc55502 优化开发环境首次载入速度 2022-06-02 01:07:20 +08:00
hooray c5c40b48b1 layout 变量全部改用 css var 2022-05-30 20:53:18 +08:00
Hooray 1d7f026fd7 404页面增加暗黑模式支持 2022-05-27 17:54:29 +08:00
hooray 379e84f1d8 更新依赖 2022-05-27 01:39:07 +08:00
hooray 314f48080b 迁移readme 2022-05-25 23:49:18 +08:00
Hooray a6f4e71248 更新依赖 2022-05-24 10:40:42 +08:00
hooray 6590d27817 element 样式覆盖文件存放目录调整 2022-05-22 18:14:49 +08:00
hooray 8f9acfcc3a 代码微调 2022-05-22 12:00:28 +08:00
hooray b286b7ffdd 优化element plus按需载入时,组件对应的样式文件会导致vite重复重载页面并加载很慢的问题 2022-05-22 04:31:07 +08:00
hooray 0d9ebc5599 优化路由配置 2022-05-21 20:15:57 +08:00
hooray 2ff29a7321 因 transition-group 组件兼容性问题,vue 版本退回 3.2.33 2022-05-21 12:05:55 +08:00
hooray c9242796ac 增加暗黑模式 2022-05-21 01:21:33 +08:00
hooray 1af46e435a 替换工具栏图标 2022-05-12 23:36:39 +08:00
hooray adec54848f 优化顶部导航样式 2022-05-12 23:26:43 +08:00
Hooray 9e3d79085f 环境变量里增加 mock 开关,解决生产环境上传组件无法上传的问题 2022-05-12 11:25:33 +08:00
hooray 396302cf9b Merge branch 'master' of https://gitee.com/hooray/fantastic-admin 2022-05-10 22:24:52 +08:00
hooray be7b528ee1 更新readme 2022-05-10 22:24:42 +08:00
Hooray 526f51a342 优化pinia使用 2022-05-10 14:42:59 +08:00
hooray 76ca25a807 更新readme 2022-05-09 00:29:07 +08:00
hooray ff7714640f 更新readme 2022-05-08 14:54:12 +08:00
hooray 99a63317f4 更新相关链接 2022-05-08 09:16:27 +08:00
hooray b97028a3b5 修改eslint配置 2022-05-07 00:30:37 +08:00
hooray cc0bcebd14 调整stylelint配置 2022-05-06 23:04:39 +08:00
Hooray f8533eb570 修改vscode推荐扩展 2022-05-06 09:24:26 +08:00
hooray 6f792ffec9 暂时解决element plus按需载入时,组件对应的样式文件会导致vite重复重载页面并加载很慢的问题 2022-05-06 02:20:48 +08:00
hooray e1344e7c91 优化unplugin-auto-import插件配置 2022-05-02 16:45:38 +08:00
hooray cf6fef85c0 优化vite-plugin-restart插件配置 2022-05-02 16:37:26 +08:00
hooray 3a05f0d84a 更新依赖 2022-05-02 16:36:48 +08:00
Hooray 0876b4311b 更新依赖 2022-04-29 02:54:38 +08:00
hooray 19ae735d2c 修改图标生成脚本,修改 .gitignore 配置 2022-04-25 23:15:27 +08:00
Hooray 61f05e52d4 优化搜索面板快捷键操作 2022-04-25 20:25:41 +08:00
Hooray 1b3740bbc6 重构图标使用方式;将element plus 改为按需导入 2022-04-25 20:21:08 +08:00
Hooray 33b9a11208 更新依赖 2022-04-25 16:39:43 +08:00
Hooray 9cf5269c33 更新依赖 2022-04-19 17:44:03 +08:00
Hooray 421e1d01bf 优化index.html 2022-04-12 03:19:56 +08:00
Hooray d213a094da 更新依赖 2022-04-12 03:17:27 +08:00
hooray 6d45383ac6 更新BuyIt组件 2022-04-09 23:53:30 +08:00
hooray 89e6903e2e 更新readme 2022-04-09 15:42:08 +08:00
hooray d627fa71c9 修复多图上传组件布局没对齐的问题 2022-04-05 04:14:31 +08:00
hooray 041933b089 代码缩进调整 2022-04-03 11:45:42 +08:00
hooray b4d66b4f34 调整浏览器升级提示 2022-04-03 02:59:58 +08:00
hooray a34a101c22 更新推广信息 2022-04-03 02:59:37 +08:00
hooray ffeef5d5b7 增加浏览器升级提示 2022-04-03 02:31:25 +08:00
hooray d2bb733d94 更新依赖 2022-04-03 02:28:16 +08:00
hooray f4c0c52f35 更新依赖 2022-03-30 02:08:48 +08:00
hooray fd31fab0fd 优化 SearchBar 组件,避免展开收起按钮被遮挡导致无法点击 2022-03-22 23:36:52 +08:00
hooray e1ea667eb1 修复个人中心基本设置无法输入的问题 2022-03-21 17:24:33 +08:00
hooray c93f635a9d 更新依赖 2022-03-15 21:33:49 +08:00
hooray 2ffc8c18d9 修改stylelint配置,优化代码 2022-03-12 09:51:33 +08:00
hooray 3685b70c2f 移除 TableHeightAdaption 组件 2022-03-11 11:10:22 +08:00
hooray ffcf9922c5 更新依赖 2022-03-09 17:06:52 +08:00
hooray c4c44297a2 Merge branch 'master' of https://gitee.com/hooray/fantastic-admin 2022-03-05 05:21:20 +08:00
hooray ff052e6769 调整 lint-staged 配置 2022-03-05 05:21:03 +08:00
hooray 2d97f31538 侧边栏导航折叠时隐藏箭头图标,代码优化 2022-03-04 10:22:57 +08:00
hooray 1c70a66a17 更新依赖 2022-03-02 15:18:52 +08:00
hooray 57e97d5322 更新依赖 2022-03-01 16:04:03 +08:00
hooray d893ca4a0d 修改文案 2022-02-27 00:57:05 +08:00
hooray 6178dd0a7f 更新推广文案 2022-02-26 17:01:17 +08:00
hooray 13a599628b 修复应用设置里 tooltip 不显示的问题 2022-02-26 15:17:27 +08:00
hooray 53e0a28a1a 更新 readme 2022-02-26 00:12:04 +08:00
hooray 2acc622e70 更新依赖 2022-02-25 18:05:00 +08:00
hooray 3c8e4f0248 更新依赖 2022-02-25 14:26:27 +08:00
hooray 7904ab66e8 增加基于文件系统的路由支持 2022-02-25 14:24:51 +08:00
hooray 35fd8f69ab 优化面包屑导航代码逻辑 2022-02-25 14:22:35 +08:00
hooray ae29c837ff 修复editor组件样式引用报错 2022-02-24 14:54:42 +08:00
hooray 6d562c2c5f 移除 Result 组件 2022-02-23 15:05:57 +08:00
hooray 6b5d432ab3 调整stylelint规则,移除无用依赖 2022-02-15 17:24:40 +08:00
hooray cfd7c2aac4 调整stylelint规则 2022-02-15 16:19:35 +08:00
hooray 3c89983ccf Merge branch 'master' of https://gitee.com/hooray/fantastic-admin 2022-02-11 09:52:00 +08:00
hooray 41c6bbf3f0 采用script、template、style的顺序优化所有sfc文件 2022-02-11 09:51:43 +08:00
hooray 6aa2275f2e 更新依赖 2022-02-11 01:26:53 +08:00
hooray 09efe7d54a 更新依赖 2022-02-07 19:42:15 +08:00
hooray 47e6fdacef 更新演示站控制台页面 2022-02-04 23:45:05 +08:00
hooray af9eb0cb06 优化menu全局状态,合并setHeaderActived和switchHeaderActived两个action 2022-02-04 03:08:35 +08:00
hooray 4ab6d83c16 search组件复原 2022-02-01 22:32:31 +08:00
hooray 393823bad9 更新依赖 2022-02-01 15:29:09 +08:00
hooray 151e510e2c 优化全局状态,将导航和路由拆分成menu和route分别管理 2022-02-01 02:31:55 +08:00
hooray c8e2d48f3a 修改默认vscode配置 2022-01-28 23:48:47 +08:00
hooray 17c6351a8c 更新依赖,更新vite插件配置 2022-01-28 10:32:13 +08:00
hooray b8c35dfc88 更新 vscode 扩展安装建议 2022-01-28 09:56:05 +08:00
hooray 445cdb08a6 更新readme 2022-01-25 23:43:15 +08:00
hooray a13d4e5a86 更新依赖 2022-01-25 11:22:24 +08:00
hooray 019fd3dc03 优化vite自动重启插件配置 2022-01-25 09:56:25 +08:00
hooray 77baee03db 更新依赖 2022-01-24 13:43:46 +08:00
hooray e41c3d9929 修复因 el-table dom结构调整导致 TableHeightAdaption 组件失效 2022-01-23 23:49:48 +08:00
hooray d55d452744 修复导航栏single模式下展示bug 2022-01-21 10:09:37 +08:00
hooray a9573ea957 增加jsx支持,以及演示代码 2022-01-20 02:13:11 +08:00
hooray 5a1d0be7b0 代码微调 2022-01-16 06:27:33 +08:00
hooray 266f8c3038 应用配置优化 2022-01-16 05:50:59 +08:00
hooray 86b49483c3 更新依赖 2022-01-16 05:23:44 +08:00
hooray b0e3bd2fb5 settings.js 参数结构调整,ThemeSetting 组件重构并更名为 AppSetting 2022-01-16 05:23:01 +08:00
hooray 8e24cb6000 优化主题配色配置,增加进度条颜色设置 2022-01-13 01:11:47 +08:00
hooray 20510ff9c9 更新依赖 2022-01-12 10:07:20 +08:00
hooray 387f17990f 代码优化,增加 vueuse 库,页面布局调整 2022-01-10 05:19:53 +08:00
hooray 1f2e8c1c6b 优化 keep-alive 动态缓存 2022-01-06 15:38:19 +08:00
hooray c195fd2bc2 优化 TableHeightAdaption 组件 2022-01-06 01:14:39 +08:00
hooray 1ff85c7bea 样式微调 2022-01-03 21:45:48 +08:00
hooray 69b358867a 更新依赖,调整 element plus 相关代码以便适配最新版本 2022-01-02 15:23:33 +08:00
hooray 5f5f5287bd 更新依赖 2021-12-30 03:13:49 +08:00
hooray 5d7461c5cc 使用 pinia 替换 vuex 2021-12-30 03:09:32 +08:00
hooray 65eff15674 优化拦截器里 toLogin 方法,先清除用户信息状态再跳转登录页 2021-12-29 04:37:49 +08:00
hooray ac02f25e84 移除 AbsoluteContainer 组件,新增 TableHeightAdaption 组件 2021-12-15 00:21:03 +08:00
hooray 435322c689 调整lint-staged配置 2021-12-13 14:53:01 +08:00
hooray 9e91f4f13e 代码微调 2021-12-11 11:23:06 +08:00
hooray 63a1e7f299 更新依赖 2021-12-11 10:21:00 +08:00
hooray 33d359b3e7 更新依赖 2021-12-10 14:16:18 +08:00
hooray 6250a39be6 更新依赖 2021-12-09 10:06:51 +08:00
hooray 0d7fa150f0 优化侧边栏宽度计算 2021-12-09 09:50:35 +08:00
hooray 5a79f120e4 修复开启切换侧边栏同时跳转页面,但子导航是外链时的bug 2021-12-08 10:17:23 +08:00
hooray 7b2110fcf2 更新依赖 2021-12-02 10:06:37 +08:00
hooray 994e918f42 更新依赖 2021-11-30 10:31:33 +08:00
hooray 3f37375677 探索版更名为 one-step-admin 2021-11-30 03:49:15 +08:00
hooray 551cf8e162 Merge branch 'master' of https://gitee.com/hooray/fantastic-admin 2021-11-30 03:32:39 +08:00
hooray 36b5dd1afb 更新readme 2021-11-30 03:32:34 +08:00
hooray e1ea02329e 更新依赖 2021-11-26 09:52:32 +08:00
hooray 42c4f6c346 增加战略合作导航栏目 2021-11-24 14:51:41 +08:00
hooray 9049807407 优化个人中心页面,使用 script setup 重写 2021-11-22 06:40:01 +08:00
hooray 93dd7a0704 更新依赖,增加 mavon-editor 2021-11-19 17:46:49 +08:00
hooray a322dd4415 优化请求拦截器 2021-11-17 14:27:40 +08:00
hooray d45d5c4c8d 优化请求拦截器里 toLogin 函数 2021-11-16 17:39:07 +08:00
hooray f2db545457 更新依赖,stylelint规则调整 2021-11-16 15:43:09 +08:00
hooray 884ffd2018 element icon 全局替换 2021-11-13 10:53:10 +08:00
hooray fdd3a63f84 优化面包屑导航数据 2021-11-13 10:44:12 +08:00
hooray c003834bd8 调整vscode配置 2021-11-12 14:34:12 +08:00
hooray 13d9908fd6 更新依赖 2021-11-11 13:49:50 +08:00
hooray b36a765fdb 优化生成路由相关代码 2021-11-11 09:27:55 +08:00
hooray 95a192b138 更新stylelint配置 2021-11-10 17:25:02 +08:00
hooray f3ba4c82f7 优化路由全局前置守卫执行逻辑 2021-11-10 10:21:36 +08:00
hooray c867f0009e 优化svg-icon组件 2021-11-08 19:46:12 +08:00
hooray b114d8a5c2 更新依赖 2021-11-06 10:14:04 +08:00
hooray 02867d8d95 代码优化 2021-11-06 09:54:49 +08:00
hooray 5a68088e39 修复权限未开启时,侧边栏原始数据被污染,导致退出再登录,侧边栏导航层级被拍平 2021-11-06 09:24:31 +08:00
hooray 9d5fd44d4e 更新readme 2021-11-05 11:12:36 +08:00
hooray b7aa15eac1 移动端下切换路由时自动收起侧边栏导航 2021-11-05 10:53:41 +08:00
hooray eff64e4e46 优化全局组件里 element icon 的使用 2021-11-04 16:01:16 +08:00
hooray c8a322dbdb 登录页用script setup语法糖重写 2021-11-04 15:20:26 +08:00
hooray 660232bbf5 更新依赖,修改 element icon 使用方式调整,优化 svg-icon 2021-11-04 15:12:48 +08:00
hooray 6dee02353b 修复开启切换侧边栏同时跳转页面的配置项后无法跳转的问题 2021-11-03 10:46:45 +08:00
hooray b7dcdb78f8 优化图片上传组件 2021-11-02 15:38:10 +08:00
hooray e74be58556 首页弹窗优化 2021-11-02 14:50:54 +08:00
hooray 48161b9e95 图片上传组件优化 2021-11-02 14:35:20 +08:00
hooray 5cfc2d4a12 更新首页弹窗 2021-11-02 14:33:24 +08:00
hooray 71c3518945 百度统计代码调整 2021-11-02 09:56:53 +08:00
hooray e2beaeab7d 更新readme 2021-11-01 22:52:52 +08:00
hooray 49d7dbb880 更新依赖 2021-10-30 00:16:38 +08:00
hooray 63d650fdcc 更新依赖 2021-10-29 04:32:48 +08:00
hooray cd9bf2880e stylelint 相关依赖升级,根据规则调整部分代码 2021-10-23 20:59:30 +08:00
hooray 10cd51cba7 更新 stylelint 相关依赖和配置 2021-10-23 15:15:22 +08:00
hooray 0d4eec44c7 更新依赖 2021-10-23 15:09:39 +08:00
hooray cbf2035e95 代码优化 2021-10-22 09:58:26 +08:00
hooray 2288cffae4 移除多余代码 2021-10-20 16:12:03 +08:00
hooray 0d34eaa5d9 移除多余代码 2021-10-20 09:15:25 +08:00
hooray 3b7ab4d4f2 代码微调,解决控制台警告 2021-10-19 02:02:07 +08:00
hooray ec57941720 更新优惠活动 2021-10-18 00:08:51 +08:00
hooray f9d6f15b5c 导航模式为侧边栏模式(不含主导航)时,优化在移动端下展示 2021-10-15 17:39:44 +08:00
hooray b199e8aef4 Merge branch 'master' of https://gitee.com/hooray/fantastic-admin 2021-10-15 13:53:53 +08:00
hooray 4537e5185d 路由后置钩子里代码精简 2021-10-15 13:53:48 +08:00
hooray 2569f0d8e9 修复后端返回路由里 auth 无效的bug 2021-10-14 19:25:36 +08:00
hooray 27a174b872 更新依赖 2021-10-14 12:07:16 +08:00
hooray 3ea84b4c77 修复导航模式为侧边栏模式(不含主导航)时,在移动端展示报错的问题 2021-10-13 16:54:15 +08:00
hooray cd6ed03e4d 优化框架判断是否为移动端设备的逻辑 2021-10-13 10:46:16 +08:00
hooray 48dc29dc14 配置推荐vscode扩展 2021-10-12 09:45:15 +08:00
hooray fb62c5b5da 移除无用文件 2021-10-12 00:35:31 +08:00
hooray 86c8b11d7a 引入 @element-plus/icons 并全局注册 2021-10-09 16:18:39 +08:00
hooray 8d9366821b 更新依赖 2021-10-08 22:43:48 +08:00
hooray 948ee44f79 优化图片上传组件 2021-10-08 16:26:10 +08:00
hooray 380281343d 修改拦截器token获取失败 2021-10-08 15:06:49 +08:00
hooray 6aefcdc8d7 更新依赖,element-plus默认中文 2021-09-29 17:00:01 +08:00
hooray 7bf40583a7 修复侧边栏导航图标显示问题 2021-09-29 09:42:42 +08:00
hooray 06c6b23539 vite配置更新 2021-09-29 02:39:11 +08:00
hooray 1a2b183737 引入 vite-plugin-vue-setup-extend 依赖,优化 plop 模版 2021-09-29 02:27:57 +08:00
hooray a6b0a82a17 移除mixins目录 2021-09-28 03:58:25 +08:00
hooray 8212249967 优化BuyIt组件展示效果 2021-09-28 01:35:52 +08:00
hooray 6031423d0e 更新依赖 2021-09-25 09:43:22 +08:00
hooray a7f5cba449 样式修改 2021-09-22 09:10:37 +08:00
hooray 86598c9003 更新依赖 2021-09-22 08:53:15 +08:00
hooray ba74283b8a 修复http-server预览指令报错的问题,vite相关相关插件配置优化 2021-09-20 07:28:10 +08:00
hooray 93bad49662 修改 unplugin-auto-import 配置 2021-09-19 15:08:10 +08:00
hooray dc0326d5eb 更新依赖 2021-09-16 08:55:22 +08:00
hooray b9d4dcfe4a 优化搜索界面,移动端不显示快捷键提示 2021-09-10 18:03:23 +08:00
hooray 9dc788d324 引入 unplugin-auto-import 依赖,修改框架部分代码 2021-09-09 16:40:22 +08:00
hooray 97122d1467 更新依赖,修改 axios baseURL设置 2021-09-09 10:34:05 +08:00
hooray a88ebdfa89 layout/ 目录下文件用 script setup 语法糖重写 2021-09-08 09:15:52 +08:00
hooray 516fcba5ed 用 script setup 语法糖重写 2021-09-07 14:40:15 +08:00
hooray 5d06055af8 layout/ 目录下文件用 script setup 语法糖重写 2021-09-07 14:29:48 +08:00
hooray 94d4a23fd2 公用组件用 script setup 语法糖重写 2021-09-04 11:13:51 +08:00
hooray 767a5c4644 修改 pre-commit 配置 2021-09-04 11:06:02 +08:00
hooray 6e8891d546 依赖更新 2021-09-03 14:44:05 +08:00
hooray aa921f32f9 修复当element默认尺寸修改后,登录页输入框图标布局中的bug 2021-09-01 10:56:52 +08:00
hooray 9bec0920a3 演示代码调整 2021-09-01 02:28:29 +08:00
hooray 73578c3eab 代码微调 2021-08-31 16:01:49 +08:00
hooray 4df04d2d07 vite配置优化 2021-08-31 00:36:17 +08:00
hooray e09880dc34 依赖更新,vite-plugin-components升级为unplugin-vue-components 2021-08-30 20:52:35 +08:00
hooray 12c7506828 移除组件全局引用,改成 vite-plugin-components 的自动引入 2021-08-30 10:08:23 +08:00
hooray 37d817af6a 更新依赖 2021-08-29 19:51:35 +08:00
hooray 5a195d87e4 导航栏增加默认打开配置项 2021-08-29 19:11:07 +08:00
hooray f48462268d 增加侧边栏导航是否保持展开一个子项的配置 2021-08-29 15:16:32 +08:00
hooray 4b89a4e86f 替换载入动画 2021-08-28 14:18:50 +08:00
hooray 2318f596dd 修改package 2021-08-27 15:17:41 +08:00
hooray fef4cd36fb first commit 2021-08-27 10:32:21 +08:00
2145 changed files with 27625 additions and 117292 deletions
@@ -1,118 +0,0 @@
---
name: fa-crud-page-generator
description: "为 Fantastic-admin 框架生成完整的 CRUD 业务模块,遵循框架标准模块结构和内建 Fa* 组件体系,使用 FaForm/FaFormItem 生成新增/编辑表单,产出列表页、详情/编辑页、DetailForm 表单组件、API 模块、fake mock 数据、可选路由。用户说:'帮我做一个商品管理页面'、'搭一个用户列表,能搜索分页新增编辑删除'、'生成订单模块'、'新建 XX 管理模块'、'快速搭一个标准模块/CRUD 页面' 时,即使没有明确说 CRUD,也应触发此技能。"
---
# CRUD 页面生成器
在 Fantastic-admin 框架中生成标准 CRUD 业务模块。生成时遵循框架当前标准模块结构:
列表页、独立详情页、`DetailForm` 表单组件、API 模块、fake mock、可选路由和 route i18n
要一次性配套生成。
优先复刻框架现有写法,而不是重新发明页面结构:列表页用 `FaSearchBar` + `FaTable` +
`FaPagination`,详情表单抽成 `components/DetailForm/index.vue`,独立详情页用
`FaFixedBar` 固定顶部标题和底部提交区。
**生成文件清单:**
- `apps/<app>/src/views/{path}/{module}/list.vue` — 列表页
- `apps/<app>/src/views/{path}/{module}/detail.vue` — 独立详情页,仅 `router` 模式需要
- `apps/<app>/src/views/{path}/{module}/components/DetailForm/index.vue` — 新增/编辑表单
- `apps/<app>/src/api/modules/{fileName}.ts` — API 模块
- `apps/<app>/src/api/fake_modules/{fileName}.fake.ts` — fake mock 数据,可选
- `apps/<app>/src/router/modules/{routeFileName}.ts` — 前端路由,可选
- `apps/<app>/src/locales/lang/route/{locale}.json` — 路由标题 i18n,可选
---
## 先确认应用
本项目是 pnpm monorepo。开始写文件前先确认目标应用:
1. 如果用户已经明确写了 `apps/<app>`、`admin 应用`、`pro 应用` 等目标应用,直接使用该应用。
2. 如果没有明确目标应用,先执行 `ls apps/` 查看可用应用,然后询问用户要生成到哪个应用,并等待回复。
3. 后续所有路径都以 `apps/<app>/src/` 为根。
不要默认猜测应用;生成到错误应用的返工成本很高。
---
## 信息收集
尽量一次性收集会影响文件结构的信息:
- **模块名**:英文,用于目录、API 文件和路由,如 `product`、`order`、`systemUser`
- **模块中文名**:用于标题和提示,如 `商品`、`订单`、`用户`
- **存放路径**:位于 `src/views/` 下的子路径,如 `mall`、`system/user`,可为空
- **字段清单**:字段名、中文标签、类型、是否列表显示、是否搜索、是否表单显示、是否必填
- **详情展示模式**:`router`、`modal`、`drawer`,默认 `router`
- **是否启用批量删除**:默认启用
- **是否支持列表高度自适应**:默认生成 `tableAutoHeight` 代码
- **是否生成 fake mock**:开发阶段默认推荐生成
- **是否生成路由和 route i18n**:仅当前端路由由本地配置维护时生成
如果用户只给出模块名和很少字段,使用一个最小可运行字段:
`title`(标题,`string`,列表/搜索/表单显示,必填),并在完成后提醒用户继续替换业务字段。
---
## 命名规范
给定模块名 `name` 和路径 `path`(相对于 `apps/<app>/src/views/`):
| 用途 | 规则 | 示例(path 为空,name=product) |
|------|------|----------------------------------------|
| 视图目录 | `src/views/{path}/{snake_case(name)}/` | `src/views/product/` |
| API 文件名 | path 参与业务命名时使用 camelCase;普通模块用 `camelCase(name)` | `product` |
| fake 文件名 | 与 API 文件名一致,放到 `src/api/fake_modules/` | `product.fake.ts` |
| 列表组件名 | `PascalCase({path}-{name}-list)` | `ProductList` |
| 详情组件名 | `PascalCase({path}-{name}-detail)` | `ProductDetail` |
| 路由 name | `camelCase(name)List` / `camelCase(name)Detail` | `productList` |
| API URL 前缀 | `snake_case(path/name)`,无前导斜杠 | `product` |
`snake_case` 用下划线连接多个单词,如 `productCategory` -> `product_category`。
---
## 代码生成规则
详细模板见 [references/templates.md](references/templates.md)。生成时按这些规则填充模板:
- `list.vue` 使用 `<script setup lang="ts">`,导入 `type { TableColumn } from '@fantastic-admin/components'`。
- 表格列使用 `computed<TableColumn<Item>[]>(...)` 定义,页面模板使用 `FaTable` 的 `:columns` 与 `#cell-xxx` 插槽。
- 搜索区使用 `FaSearchBar` + `FaLabel`,按钮保持“重置 / 筛选 / 展开收起”的顺序。
- 工具栏通过 `FaTable` 的 `#toolbar` 插槽放“新增”和批量操作。
- 行操作用 `FaButton size="icon-sm"` 编辑按钮和 `FaDropdown` 删除菜单。
- 删除确认统一使用 `useFaModal().confirm`,提示成功统一使用 `useFaToast().success`。
- `router` 模式在列表页通过 `eventBus.on('get-data-list')` 接收详情页提交后的刷新事件;卸载时 `eventBus.off('get-data-list')`。
- `modal` / `drawer` 模式通过 `useFaModal().create` 或 `useFaDrawer().create` 渲染 `DetailForm`,confirm 时调用表单暴露的 `submit()`;仅当返回 `true` 时刷新列表并关闭。
- `DetailForm` 使用 `FaForm/FaFormItem`,表单对象使用 `const model = ref<...>({...})`,通过 `useTemplateRef<FormExpose>('formRef')` 获取表单引用,并只 `defineExpose({ submit })` 给外部调用。
- `submit()` 必须返回 `Promise<boolean>`:校验失败返回 `false`,新增/编辑成功后提示并返回 `true`。父级页面、modal、drawer 都必须检查返回值,避免校验失败时关闭页面或弹窗。
- fake mock 文件放在 `apps/<app>/src/api/fake_modules/`,不是 `api/modules/`。
- API 模块开启 mock 时在每个请求配置中设置 `fake: true`;不生成 fake 时去掉 `fake: true`。
---
## 路由生成
如果用户选择生成路由,优先调用或参考 `fa-route-generator`,并遵循最新标准模块路由模式:
- 父级路由指向 `Layout`,`meta.title` 使用 `$t('route.<module>.root')`,设置合适图标。
- 列表子路由 `path: ''`,`name: '<module>List'`,组件指向 `list.vue`。
- 当父级路由只作为菜单入口、列表页作为默认子页时,列表路由使用 `meta.menu: false` 和 `breadcrumb: false`;业务模块如需列表作为独立菜单项,可按用户需求保留菜单。
- `router` 模式详情路由为 `detail/:id?`,`meta.menu: false`,`activeMenu` 指向列表/父菜单路径。
- 为避免列表和详情标签页状态混乱,列表路由设置 `keepAlive: '<module>Detail'`,详情路由设置 `keepAlive: true` 与 `noKeepAlive: '<module>List'`。
- route i18n 至少同步 `zh-cn`、`zh-tw`、`en` 三份 `src/locales/lang/route/*.json`。
---
## 生成前后检查
写文件前展示将生成/修改的文件列表,确认不会覆盖用户已有业务文件。若目标文件已存在,先读取并说明将如何合并。
完成后简要说明:
- 已生成哪些文件;
- 若未生成路由,提示可继续用 `fa-route-generator` 添加;
- 若生成 fake mock,说明请求已配置 `fake: true`;
- 若字段是枚举、状态、日期、上传等复杂类型,提醒用户按业务替换控件和 mock 取值。
不要修改 `packages/components/` 内建组件;确实需要改内建组件时先征得用户确认。
@@ -1,872 +0,0 @@
# CRUD 代码模板
生成业务模块时优先保持结构一致,再按字段和业务控件做替换。
## 占位符
- `{cname}` — 模块中文名,如 `商品`
- `{moduleName}` — 模块英文名 camelCase,如 `product`
- `{ModuleName}` — 模块英文名 PascalCase,如 `Product`
- `{fileName}` — API 文件名,如 `product`
- `{apiPrefix}` — API URL 前缀,无前导斜杠,如 `product`
- `{componentNameList}` — 列表页组件名,如 `ProductList`
- `{componentNameDetail}` — 详情页组件名,如 `ProductDetail`
- `{routeListName}` — 列表路由 name,如 `productList`
- `{routeDetailName}` — 详情路由 name,如 `productDetail`
- `{routeRootName}` — 父级路由 name,如 `product`
- `{routePath}` — 父级路由 path,如 `/product`
- `{routeTitle}` — 路由标题,如 `商品管理`
- `{formMode}` — `router`、`modal` 或 `drawer`
- `{firstField}` — 删除确认中展示的主字段,如 `title`
- `{formModelTypes}` — `DetailFormModel` 中除 `id` 外的字段类型
- `{formValidationSchema}` — `FaForm` 的 validation schema 对象字段
---
## list.vue 模板
```vue
<script setup lang="ts">
import type { TableColumn } from '@fantastic-admin/components'
import api{ModuleName} from '@/api/modules/{fileName}'
import eventBus from '@/utils/eventBus'
import DetailForm from './components/DetailForm/index.vue'
defineOptions({
name: '{componentNameList}',
})
interface {ModuleName}Item {
id: number
{itemTypeFields}
}
const router = useRouter()
const { pagination, getParams, onSizeChange, onCurrentChange } = usePagination()
// 表格是否自适应高度
const tableAutoHeight = ref(false)
/**
* 详情展示模式
* router 路由跳转
* modal 模态框
* drawer 抽屉
*/
const formMode = ref<'router' | 'modal' | 'drawer'>('{formMode}')
// 详情
const formModeProps = ref({
id: '' as number | string,
})
// 搜索
const searchDefault = {
{searchDefaults}
}
const search = ref({ ...searchDefault })
function searchReset() {
Object.assign(search.value, searchDefault)
}
// 批量操作
const batch = ref({
enable: true,
selectionDataList: [] as {ModuleName}Item[],
})
// 列表
const loading = ref(false)
const dataList = ref<{ModuleName}Item[]>([])
const tableColumns = computed<TableColumn<{ModuleName}Item>[]>(() => [
...(batch.value.enable
? [{
type: 'selection',
fixed: 'left',
width: 48,
} satisfies TableColumn<{ModuleName}Item>]
: []),
{tableColumns}
{
id: 'operation',
header: '操作',
width: 120,
align: 'center',
fixed: 'right',
},
])
onMounted(() => {
getDataList()
if (formMode.value === 'router') {
eventBus.on('get-data-list', () => {
getDataList()
})
}
})
onBeforeUnmount(() => {
if (formMode.value === 'router') {
eventBus.off('get-data-list')
}
})
function getDataList() {
loading.value = true
const params = {
...getParams(),
{searchParams}
}
api{ModuleName}.list(params).then((res: any) => {
loading.value = false
dataList.value = res.data.list
pagination.value.total = res.data.total
})
}
// 每页数量切换
function sizeChange(size: number) {
onSizeChange(size).then(() => getDataList())
}
// 当前页码切换(翻页)
function currentChange(page = 1) {
onCurrentChange(page).then(() => getDataList())
}
const formRef = ref<InstanceType<typeof DetailForm>>()
const { open: openModal, update: updateModal } = useFaModal().create({
destroyOnClose: true,
closeOnClickOverlay: false,
closeOnPressEscape: false,
beforeClose: (action, done) => {
if (action === 'confirm') {
// 调用 DetailForm 组件内部 submit 方法
formRef.value?.submit().then((success) => {
if (!success) {
return
}
getDataList()
done()
})
}
else {
done()
}
},
content: () => h(DetailForm, {
ref: formRef,
id: formModeProps.value.id,
}),
})
const { open: openDrawer, update: updateDrawer } = useFaDrawer().create({
destroyOnClose: true,
closeOnClickOverlay: false,
closeOnPressEscape: false,
beforeClose: (action, done) => {
if (action === 'confirm') {
// 调用 DetailForm 组件内部 submit 方法
formRef.value?.submit().then((success) => {
if (!success) {
return
}
getDataList()
done()
})
}
else {
done()
}
},
content: () => h(DetailForm, {
ref: formRef,
id: formModeProps.value.id,
}),
})
function onCreate() {
if (formMode.value === 'router') {
router.push({
name: '{routeDetailName}',
})
}
else {
formModeProps.value.id = ''
if (formMode.value === 'modal') {
updateModal({
title: '新增{cname}',
})
openModal()
}
else {
updateDrawer({
title: '新增{cname}',
})
openDrawer()
}
}
}
function onEdit(row: {ModuleName}Item) {
if (formMode.value === 'router') {
router.push({
name: '{routeDetailName}',
params: {
id: row.id,
},
})
}
else {
formModeProps.value.id = row.id
if (formMode.value === 'modal') {
updateModal({
title: '编辑{cname}',
})
openModal()
}
else {
updateDrawer({
title: '编辑{cname}',
})
openDrawer()
}
}
}
function onDel(row: {ModuleName}Item) {
useFaModal().confirm({
title: '确认信息',
content: `确认删除「${row.{firstField}}」吗?`,
onConfirm: () => {
api{ModuleName}.delete(row.id).then(() => {
getDataList()
useFaToast().success('删除成功')
})
},
})
}
function onBatchDel() {
const rows = batch.value.selectionDataList
if (!rows.length) {
return
}
useFaModal().confirm({
title: '确认信息',
content: `确认删除选中的 ${rows.length} 条数据吗?`,
onConfirm: () => {
Promise.all(rows.map(row => api{ModuleName}.delete(row.id))).then(() => {
getDataList()
useFaToast().success('批量删除成功')
})
},
})
}
</script>
<template>
<div :class="{ 'absolute flex flex-col size-full': tableAutoHeight }">
<FaPageHeader title="{cname}管理" class="mb-0" />
<FaPageMain :class="{ 'flex-1 overflow-auto': tableAutoHeight }" :main-class="{ 'flex-1 flex flex-col overflow-auto': tableAutoHeight }">
<FaSearchBar :show-toggle="false">
<template #default="{ fold, toggle }">
<div class="gap-x-8 gap-y-2 grid grid-cols-[repeat(auto-fit,minmax(300px,1fr))]">
{searchFields}
<div class="flex gap-2 col-end--1 justify-end">
<FaButton variant="outline" @click="searchReset(); currentChange()">
重置
</FaButton>
<FaButton type="primary" @click="currentChange()">
<FaIcon name="i-ri:search-line" />
筛选
</FaButton>
<FaButton variant="ghost" @click="toggle">
{{ fold ? '展开' : '收起' }}
<FaIcon :name="fold ? 'i-ep:caret-bottom' : 'i-ep:caret-top'" />
</FaButton>
</div>
</div>
</template>
</FaSearchBar>
<div class="mx--4 my-3 border-t border-t-dashed" />
<FaTable
v-loading="loading"
table-root-class="rounded-lg overflow-hidden"
:class="{ 'min-h-0 flex-1': tableAutoHeight }"
row-key="id"
selectable
multiple
stripe
column-visibility
border
:columns="tableColumns"
:data="dataList"
@selection-change="batch.selectionDataList = $event"
>
<template #toolbar>
<div class="flex flex-1 gap-2 items-center">
<FaButton @click="onCreate">
新增
</FaButton>
<FaDropdown
v-if="batch.enable"
:items="[
[
{ label: '批量删除', variant: 'destructive', disabled: !batch.selectionDataList.length, handle: onBatchDel },
],
]"
>
<FaButton variant="outline" :disabled="!batch.selectionDataList.length">
批量操作
<FaIcon name="i-ep:arrow-down" />
</FaButton>
</FaDropdown>
</div>
</template>
{tableCellSlots}
<template #cell-operation="{ row }">
<div class="flex-center gap-2">
<FaButton variant="outline" size="icon-sm" @click="onEdit(row.original)">
<FaIcon name="i-ri:edit-line" />
</FaButton>
<FaDropdown
:items="[
[
{ label: '删除', variant: 'destructive', handle: () => onDel(row.original) },
],
]"
>
<FaButton variant="outline" size="icon-sm">
<FaIcon name="i-ri:more-line" />
</FaButton>
</FaDropdown>
</div>
</template>
</FaTable>
<FaPagination :page="pagination.page" :size="pagination.size" :total="pagination.total" class="mt-2" @page-change="currentChange" @size-change="sizeChange" />
</FaPageMain>
</div>
</template>
```
业务页面保持简洁标题即可,不要在 `FaPageHeader #description` 中加入解释技能或模板来源的说明文字。
---
## detail.vue 模板(router 模式)
```vue
<script setup lang="ts">
import eventBus from '@/utils/eventBus'
import DetailForm from './components/DetailForm/index.vue'
defineOptions({
name: '{componentNameDetail}',
})
const route = useRoute()
const router = useRouter()
const appPage = useAppPage()
onMounted(() => {
appPage.setCustomTitle(route.params.id ? '编辑' : '新增')
})
onUnmounted(() => {
appPage.resetCustomTitle()
})
const formRef = useTemplateRef('formRef')
function onSubmit() {
formRef.value?.submit().then((success) => {
if (!success) {
return
}
eventBus.emit('get-data-list')
onCancel()
})
}
function onCancel() {
router.back({ name: '{routeListName}' })
}
</script>
<template>
<div>
<FaFixedBar position="top" class="p-0">
<FaPageHeader :title="route.params.id ? '编辑{cname}' : '新增{cname}'" class="mb-0 border-b-none">
<FaButton variant="outline" size="sm" class="rounded-full" @click="onCancel">
<FaIcon name="i-ep:arrow-left" />
返回
</FaButton>
</FaPageHeader>
</FaFixedBar>
<FaPageMain>
<div class="max-w-4xl w-full">
<DetailForm :id="route.params.id as string" ref="formRef" />
</div>
</FaPageMain>
<FaFixedBar position="bottom" class="flex-center gap-4">
<FaButton @click="onSubmit">
提交
</FaButton>
<FaButton variant="outline" @click="onCancel">
取消
</FaButton>
</FaFixedBar>
</div>
</template>
```
---
## components/DetailForm/index.vue 模板
```vue
<script setup lang="ts">
import type { FormExpose } from '@fantastic-admin/components'
import { ref } from 'vue'
import api{ModuleName} from '@/api/modules/{fileName}'
export interface Props {
id?: number | string
}
const props = withDefaults(
defineProps<Props>(),
{
id: '',
},
)
const loading = ref(false)
const formRef = useTemplateRef<FormExpose>('formRef')
interface DetailFormModel {
id: number | string
{formModelTypes}
}
const model = ref<DetailFormModel>({
id: props.id,
{formInitialValues}
})
const validationSchema = {
{formValidationSchema}
}
onMounted(() => {
if (model.value.id !== '') {
getInfo()
}
})
function getInfo() {
loading.value = true
api{ModuleName}.detail(model.value.id).then((res: any) => {
loading.value = false
{formAssign}
}).catch(() => {
loading.value = false
})
}
async function submit() {
const result = await formRef.value?.validate()
if (!result?.valid) {
return false
}
if (model.value.id === '') {
await api{ModuleName}.create(model.value)
useFaToast().success('新增成功')
}
else {
await api{ModuleName}.edit(model.value)
useFaToast().success('编辑成功')
}
return true
}
defineExpose({
submit,
})
</script>
<template>
<div v-loading="loading">
<FaForm
ref="formRef"
:model="model"
:validation-schema="validationSchema"
label-placement="right"
:label-width="120"
>
{formFields}
</FaForm>
</div>
</template>
```
---
## api/modules/{fileName}.ts 模板
```typescript
import api from '../index'
export default {
list: (data: {
{searchTypes}
from: number
limit: number
}) => api.get('{apiPrefix}/list', {
params: data,
fake: true,
}),
detail: (id: number | string) => api.get('{apiPrefix}/detail', {
params: {
id,
},
fake: true,
}),
create: (data: any) => api.post('{apiPrefix}/create', data, {
fake: true,
}),
edit: (data: any) => api.post('{apiPrefix}/edit', data, {
fake: true,
}),
delete: (id: number | string) => api.post('{apiPrefix}/delete', {
id,
}, {
fake: true,
}),
}
```
不生成 fake mock 时,去掉所有 `fake: true` 配置,并确保接口地址与真实后端约定一致。
---
## api/fake_modules/{fileName}.fake.ts 模板
```typescript
import { faker } from '@faker-js/faker'
import { defineFakeRoute } from 'vite-plugin-fake-server/client'
// {cname}
const {moduleName}List: any[] = []
for (let i = 0; i < 50; i++) {
{moduleName}List.push({
id: i + 1,
{mockFields}
})
}
export default defineFakeRoute([
{
url: '/fake/{apiPrefix}/list',
method: 'get',
response: ({ query }) => {
const { {searchQueryFields}, from, limit } = query
const list = {moduleName}List.filter((item) => {
return {searchFilterExpression}
})
const pageList = list.filter((_item, index) => {
return index >= ~~from && index < (~~from + ~~limit)
})
return {
error: '',
status: 1,
data: {
list: pageList,
total: list.length,
},
}
},
},
{
url: '/fake/{apiPrefix}/detail',
method: 'get',
response: ({ query }) => {
const info = {moduleName}List.filter(item => item.id === ~~query.id)
return {
error: '',
status: 1,
data: info[0],
}
},
},
{
url: '/fake/{apiPrefix}/create',
method: 'post',
response: () => {
return {
error: '',
status: 1,
data: {
isSuccess: true,
},
}
},
},
{
url: '/fake/{apiPrefix}/edit',
method: 'post',
response: () => {
return {
error: '',
status: 1,
data: {
isSuccess: true,
},
}
},
},
{
url: '/fake/{apiPrefix}/delete',
method: 'post',
response: () => {
return {
error: '',
status: 1,
data: {
isSuccess: true,
},
}
},
},
])
```
如果有多个搜索字段,可以用 `&&` 组合过滤条件:
```typescript
return (title ? item.title.includes(title) : true)
&& (status !== undefined && status !== '' ? item.status === ~~status : true)
```
---
## router/modules/{routeFileName}.ts 模板
```typescript
import type { RouteRecordRaw } from 'vue-router'
import { $t } from '@/locales'
function Layout() {
return import('@/layouts/index.vue')
}
const routes: RouteRecordRaw = {
path: '{routePath}',
component: Layout,
name: '{routeRootName}',
meta: {
title: '{routeTitle}',
icon: '{icon}',
},
children: [
{
path: '',
name: '{routeListName}',
component: () => import('@/views/{viewPath}/list.vue'),
meta: {
title: '{cname}列表',
menu: false,
breadcrumb: false,
keepAlive: '{routeDetailName}',
},
},
{
path: 'detail/:id?',
name: '{routeDetailName}',
component: () => import('@/views/{viewPath}/detail.vue'),
meta: {
title: '...',
menu: false,
activeMenu: '{routePath}',
keepAlive: true,
noKeepAlive: '{routeListName}',
},
},
],
}
export default routes
```
`modal` / `drawer` 模式不需要详情路由,列表路由也不需要 `keepAlive: '{routeDetailName}'`。
---
## 字段生成规则
### TypeScript item 字段
```typescript
title: string
status: number
createdAt: string
```
### 搜索默认值和查询参数
```typescript
const searchDefault = {
title: '',
status: '',
}
const params = {
...getParams(),
...(search.value.title && { title: search.value.title }),
...(search.value.status !== '' && { status: search.value.status }),
}
```
### 搜索栏字段
首个主要搜索字段直接显示,次要搜索条件使用 `v-show="!fold"`:
```vue
<FaLabel label="{label}" class="col-span-1">
<FaInput
v-model="search.{field}"
placeholder="请输入{label},支持模糊查询"
clearable
class="w-full"
@keydown.enter="currentChange()"
@clear="currentChange()"
/>
</FaLabel>
```
### FaTable 列
普通字段:
```typescript
{
accessorKey: '{field}',
header: '{label}',
},
```
需要自定义展示的字段使用 `id`,并在模板里添加 `#cell-{id}` 插槽:
```typescript
{
id: 'status',
header: '状态',
width: 100,
align: 'center',
},
```
```vue
<template #cell-status="{ row }">
<FaBadge :variant="row.original.status ? 'default' : 'secondary'">
{{ row.original.status ? '启用' : '停用' }}
</FaBadge>
</template>
```
### 表单字段
```vue
<FaFormItem name="{field}" label="{label}" required>
<FaInput placeholder="请输入{label}" class="w-full" />
</FaFormItem>
```
`FaFormItem` 会自动向第一个子控件注入 `modelValue` 和 `onUpdate:modelValue`,不要再手写
`v-model="model.{field}"` 或 `v-model="model.value.{field}"`。
### 表单 model 类型字段
```typescript
{field}: string
status: number
enabled: boolean
```
### 表单初始值
```typescript
{field}: '',
status: 0,
enabled: true,
```
### 表单详情赋值
```typescript
model.value.{field} = res.data.{field}
```
### 表单验证 schema
文本输入:
```typescript
{field}(value: string) {
return value?.trim() ? true : '请输入{label}'
},
```
选择、开关、日期:
```typescript
{field}(value: string | number | boolean | undefined) {
return value !== undefined && value !== '' ? true : '请选择{label}'
},
```
非必填字段不要生成 validation schema 项;生成必填字段时,在对应 `FaFormItem` 上同时加
`required`。
### Mock 数据字段映射
| 字段类型/含义 | faker 方法 |
|---------------|------------|
| 标题 | `faker.book.title()` 或 `faker.lorem.words(3)` |
| 名称 | `faker.person.fullName()` 或 `faker.commerce.productName()` |
| 用户名 | `faker.internet.username()` |
| 手机号 | `faker.phone.number()` |
| 邮箱 | `faker.internet.email()` |
| 描述 | `faker.lorem.sentence()` |
| 数量 | `faker.number.int({ min: 1, max: 100 })` |
| 金额 | `faker.number.float({ min: 10, max: 9999, fractionDigits: 2 })` |
| 布尔状态 | `faker.datatype.boolean()` |
| 枚举状态 | `faker.helpers.arrayElement([0, 1, 2])` |
| 日期 | `faker.date.recent().toISOString()` |
### Mock 搜索过滤
字符串模糊匹配:
```typescript
title ? item.title.includes(title) : true
```
数字/枚举精确匹配。注意 query 参数是字符串,`0` 不能用普通 truthy 判断:
```typescript
status !== undefined && status !== '' ? item.status === ~~status : true
```
-135
View File
@@ -1,135 +0,0 @@
---
name: fa-feedback
description: 当用户在使用 fa-* 系列技能(如 fa-framework-settings、fa-slot-creator、fa-form-builder、fa-route-generator、fa-store-generator、fa-page-optimizer、fa-theme-customizer 等)时,在同一个目标上经历了 3 次及以上的修改仍未达到预期效果,必须触发此技能。触发信号包括:用户反复要求调整同一处配置或代码、连续说"不对"/"再改改"/"还是不行"、对同一个功能点多次提出修正意见。即使用户没有明确表示"上报"或"反馈",只要检测到反复沟通修改的模式,就应主动触发。
---
# Fantastic-admin 问题反馈
当用户在使用 fa-* 系列技能时遇到反复修改仍无法达到预期的情况,这通常意味着框架本身可能存在改进空间(比如 skill 指令不够精确、框架 API 不够直观、文档缺失等)。此时应主动询问用户是否愿意将问题反馈给框架作者。
## 触发条件
在当前对话中,如果满足以下任一条件,则触发此技能:
1. **同一目标的修改次数 >= 3 次**:用户针对同一个功能点或配置项,已经要求修改 3 次及以上
2. **用户表达持续不满**:用户连续使用"不对"、"还是不行"、"再试试"、"跟我说的不一样"等表述
3. **循环修改模式**:修改 A -> 改回 -> 再改 A,出现来回反复的情况
## 执行流程
### 第一步:分析问题
回顾当前对话历史,提炼以下信息:
1. **使用的技能**:用户在使用哪个 fa-* 技能
2. **用户的原始需求**:用户最初想要实现什么
3. **反复修改的焦点**:哪个具体的配置项/代码/功能点在被反复调整
4. **未达预期的原因**:为什么始终无法满足用户的需求(是 skill 指令有误?框架 API 限制?还是理解偏差?)
### 第二步:询问用户
用以下方式询问用户(注意语气要友好自然,不要让用户感到被指责):
```
我注意到在 [具体功能] 上我们已经来回调整了好几次,这很可能说明框架的 [skill/文档/API] 在这方面有改进空间。
你是否愿意将这个问题反馈给 Fantastic-admin 的作者?这有助于改进框架,让以后的使用体验更好。
如果你同意,我会帮你整理一份精简的问题描述,然后打开 GitHub Discussions 页面,内容会自动填好,你只需要检查一下就可以提交。
```
- 如果用户**同意**,继续第三步
- 如果用户**拒绝**,尊重用户的决定,继续协助解决当前问题,不再提及反馈
### 第三步:整理反馈内容
生成精简的反馈报告,格式如下:
**标题**(简洁明了,一句话概括问题):
```
[技能名称] 在 [场景] 下无法正确 [操作]
```
**正文**(使用 Markdown 格式):
```markdown
## 问题描述
[一句话说明用户想做什么,以及遇到了什么问题]
## 使用的技能
[fa-xxx-xxx]
## 复现步骤
1. [用户的原始请求]
2. [第一次修改及结果]
3. [后续修改及结果]
## 期望行为
[用户期望的结果是什么]
## 实际行为
[实际发生了什么,为什么不符合预期]
## 可能的原因
[基于分析,推测问题可能出在哪里,比如 skill 指令、框架 API、默认配置等]
```
内容整理原则:
- **精简**:只保留关键信息,去掉对话中的冗余内容
- **客观**:描述事实,不添加情绪化表达
- **可操作**:让框架作者看到后能理解问题并采取行动
### 第四步:生成链接并打开
将整理好的标题和正文通过 URL 参数编码,拼接到 GitHub Discussions 链接中:
```
https://github.com/orgs/fantastic-admin/discussions/new?category=通用&title={编码后的标题}&body={编码后的正文}
```
使用以下方式生成并打开链接:
```bash
# 生成 URL 编码的链接并打开
python3 -c "
import urllib.parse
import subprocess
title = '''在此填入标题'''
body = '''在此填入正文'''
params = urllib.parse.urlencode({
'category': '通用',
'title': title,
'body': body
}, quote_via=urllib.parse.quote)
url = f'https://github.com/orgs/fantastic-admin/discussions/new?{params}'
print(f'链接已生成:{url}')
subprocess.run(['open', url])
"
```
打开链接后,告诉用户:
```
已在浏览器中打开 GitHub Discussions 页面。请检查预填的内容是否准确,确认无误后点击提交即可。
如果页面中的标题和内容没有自动填充(GitHub Discussions 可能不支持 URL 参数预填),你可以手动复制以下内容:
**标题**:[标题内容]
**内容**:
[正文内容]
```
始终同时展示原文内容作为备选方案,确保用户无论 URL 参数是否生效都能顺利提交反馈。
### 第五步:继续协助
反馈流程完成后,继续协助用户解决当前的问题,不要因为反馈流程中断用户的工作。
-89
View File
@@ -1,89 +0,0 @@
---
name: fa-form-builder
description: "为 Fantastic-admin 框架生成独立的表单页面,使用 FaForm/FaFormItem + vee-validate + zod 验证,表单 model 使用 ref,全部使用框架内建 Fa* 组件。当用户说:'帮我做一个用户信息填写页'、'我只需要一个提交表单,不需要列表'、'做个设置页面,有几个输入框和保存按钮'、'生成一个注册/编辑/配置表单页'、'只要表单页,不需要增删改查',即使用户只是说'做个表单页面'也应触发此技能。"
---
# 表单页面生成器
在 Fantastic-admin 框架中生成独立的 Router 表单页面,使用 `FaForm/FaFormItem` 承接 vee-validate + zod 表单验证。
**生成的文件:**
- `apps/<app>/src/views/{path}/{name}/index.vue` — 表单页面(含验证、提交骨架、固定操作栏)
---
## 第一步:确认工作区(必须阻塞等待用户回复)
本项目是 monorepo 架构,`apps/` 目录下存放各应用。**在执行任何文件读写操作之前**,必须先确认目标应用:
1. 执行 `ls apps/` 列出所有可用应用
2. **立即向用户提问**,明确询问要在哪个应用中生成表单页面,并**停止等待回复**
3. 收到用户明确回复后,才能继续后续步骤
> **严格规则**:如果用户没有在请求中明确说明目标应用(例如"在 example 应用中"、"apps/core"),则必须提问,不得自行猜测或默认选择任何应用。
确认后,后续所有文件路径均以该应用目录为根。
---
## 工作流程
### Step 1:收集基本信息
向用户询问(可合并为一次提问):
1. **模块名**(英文,用于文件路径,如 `user`、`profile`、`setting`)
2. **模块中文名**(用于页面标题,如 `用户信息`、`个人资料`)
3. **存放路径**(在 `apps/<app>/src/views/` 下的子目录,如 `system`、`account`,留空则直接放在 `src/views/` 下)
### Step 2:收集字段信息
询问用户该表单有哪些字段,每个字段需要:
- **字段名**(英文,如 `name`、`avatar`、`status`)
- **中文标签**(如 `姓名`、`头像`、`状态`)
- **字段类型**(见 references/templates.md 中的字段类型映射表)
- **是否必填**
如果用户没有提供字段信息,使用默认字段 `title`(标题,string,必填)作为示例占位,并在生成后提示用户替换。
### Step 3:判断布局
字段较多时单列会导致页面过长,双列更紧凑。根据字段数量和复杂度判断是否询问用户布局偏好:
- **单列**:`max-w-600px`,`grid gap-6`(字段少、字段较长时适合)
- **双列**:`max-w-1200px`,`grid grid-cols-1 gap-x-8 gap-y-6 items-start md:grid-cols-2`(字段多、字段较短时适合)
### Step 4:确认并生成
汇总信息,展示将要生成的文件,确认后写入。
生成完成后提示:如需配置路由,请使用 `fa-route-generator` 技能;如需 API 模块,请使用 `fa-crud-page-generator` 或手动创建。
---
## 命名规范
给定模块名 `name` 和路径 `path`(相对于 `apps/<app>/src/views/`):
| 用途 | 规则 | 示例(path=system, name=user) |
|------|------|-------------------------------|
| 视图目录 | `apps/<app>/src/views/{path}/{name}/` | `apps/<app>/src/views/system/user/` |
| 组件名 | `PascalCase({path}-{name}-form)` | `SystemUserForm` |
---
## 代码模板
详细的代码模板和字段类型映射表见 [references/templates.md](references/templates.md)。
生成代码时替换模板中的占位符:
- `{cname}` → 模块中文名
- `{componentName}` → PascalCase 组件名
- `{zodSchema}` → zod 字段定义(每个必填字段对应一行 zod 规则)
- `{initialValues}` → `model` 字段初始值(string 默认 `''`,boolean 默认 `false`,number 默认 `0`,array 默认 `[]`)
- `{formItems}` → 各字段对应的 FaFormItem 代码片段
- `{imports}` → 必要的额外 import;默认留空,Fa* 组件通常由自动导入处理
- `{maxWidth}` → 单列 `max-w-600px` / 双列 `max-w-1200px`
- `{gridClass}` → 双列时 `grid grid-cols-1 gap-x-8 gap-y-6 items-start md:grid-cols-2` / 单列时 `grid gap-6`
生成的代码是骨架:API 调用处用 `// TODO:` 注释标记,动态数据源(select options、upload action 等)用占位注释标记,用户根据实际接口替换。表单对象必须使用 `const model = ref({...})`,模板中直接 `:model="model"`;脚本里读写字段使用 `model.value.xxx`。操作栏按钮使用 `FaButton`:取消用 `variant="outline"`,提交用默认 variant 并传 `:loading="loading"`。
@@ -1,240 +0,0 @@
# 表单页面代码模板
使用 FaForm/FaFormItem + vee-validate + zod 验证。
占位符说明:
- `{cname}` — 模块中文名
- `{componentName}` — 组件名(PascalCase)
- `{zodSchema}` — zod 字段定义
- `{initialValues}` — `model` 表单初始值
- `{formItems}` — FaFormItem 列表
- `{imports}` — 需要手动 import 的组件
- `{maxWidth}` — 单列 `max-w-600px` / 双列 `max-w-1200px`
- `{gridClass}` — 双列时 `grid grid-cols-1 gap-x-8 gap-y-6 items-start md:grid-cols-2` / 单列时 `grid gap-6`
---
## index.vue 模板
```vue
<script setup lang="ts">
import type { FormExpose } from '@fantastic-admin/components'
import { toTypedSchema } from '@vee-validate/zod'
import { ref } from 'vue'
import * as z from 'zod'
{imports}
defineOptions({
name: '{componentName}',
})
const router = useRouter()
const formRef = useTemplateRef<FormExpose>('formRef')
const loading = ref(false)
const model = ref({
{initialValues}
})
const validationSchema = toTypedSchema(z.object({
{zodSchema}
}))
async function onSubmit(values: typeof model.value) {
loading.value = true
try {
// TODO: 调用 API,如 apiXxx.create(values) 或 apiXxx.edit(values)
}
finally {
loading.value = false
}
}
async function submit() {
await formRef.value?.submit()
}
function handleCancel() {
router.back()
}
</script>
<template>
<div>
<FaPageHeader title="{cname}" />
<FaPageMain>
<div v-loading="loading" class="mx-auto {maxWidth}">
<FaForm
ref="formRef"
:model="model"
:validation-schema="validationSchema"
class="{gridClass}"
@submit="onSubmit"
>
{formItems}
</FaForm>
</div>
</FaPageMain>
<FaFixedBar position="bottom" class="flex gap-2 justify-center">
<FaButton type="button" variant="outline" @click="handleCancel">
取消
</FaButton>
<FaButton type="button" :loading="loading" @click="submit">
提交
</FaButton>
</FaFixedBar>
</div>
</template>
```
---
## 各字段类型的 FaFormItem 片段
```vue
<!-- FaInput(文本) -->
<FaFormItem name="{field}" label="{label}" required>
<FaInput placeholder="请输入{label}" class="w-full" />
</FaFormItem>
<!-- FaInput(密码)+ FaPasswordStrength -->
<FaFormItem name="{field}" label="{label}" required>
<FaInput type="password" placeholder="请输入{label}" class="w-full" />
<template #description="{ value }">
<FaPasswordStrength :password="(value as string) ?? ''" />
</template>
</FaFormItem>
<!-- FaTextarea -->
<FaFormItem name="{field}" label="{label}" required>
<FaTextarea placeholder="请输入{label}" class="w-full" />
</FaFormItem>
<!-- FaSelect -->
<FaFormItem name="{field}" label="{label}" required>
<FaSelect :options="{field}Options" placeholder="请选择{label}" class="w-full" />
</FaFormItem>
<!-- script 中同时生成 options 占位:const {field}Options = ref([{ label: '选项1', value: 1 }]) -->
<!-- FaSwitch -->
<FaFormItem name="{field}" label="{label}">
<FaSwitch />
</FaFormItem>
<!-- FaCheckbox(多选,手动维护数组) -->
<FaFormItem name="{field}" label="{label}">
<template #default="{ value, setValue }">
<div class="flex flex-wrap gap-4">
<FaCheckbox
v-for="opt in {field}Options"
:key="opt.value"
:model-value="((value as string[] | undefined) ?? []).includes(opt.value)"
@update:model-value="(checked) => setValue(checked ? [...((value as string[] | undefined) ?? []), opt.value] : ((value as string[] | undefined) ?? []).filter(v => v !== opt.value))"
>
{{ opt.label }}
</FaCheckbox>
</div>
</template>
</FaFormItem>
<!-- script 中同时生成 options 占位:const {field}Options = [{ label: '选项1', value: '1' }] -->
<!-- 日期 -->
<FaFormItem name="{field}" label="{label}" required>
<FaInput type="date" class="w-full" />
</FaFormItem>
<!-- 日期时间 -->
<FaFormItem name="{field}" label="{label}" required>
<FaInput type="datetime-local" class="w-full" />
</FaFormItem>
<!-- FaImageUpload -->
<FaFormItem name="{field}" label="{label}" required>
<FaImageUpload action="/upload/image" />
</FaFormItem>
<!-- FaFileUpload -->
<FaFormItem name="{field}" label="{label}" required>
<FaFileUpload action="/upload/file" />
</FaFormItem>
<!-- FaIconPicker -->
<FaFormItem name="{field}" label="{label}">
<FaIconPicker />
</FaFormItem>
<!-- FaNumberField -->
<FaFormItem name="{field}" label="{label}" required>
<FaNumberField class="w-full" />
</FaFormItem>
<!-- 双列布局中需要占满整行的字段,加 md:col-span-2 -->
<!-- <FaFormItem name="{field}" label="{label}" class="md:col-span-2"> -->
```
`FaFormItem` 会自动向第一个子控件注入 `modelValue` 和 `onUpdate:modelValue`,默认不要手写
`v-model`。只有多选、组合控件等非单一控件场景,才使用 slot props 手动调用 `setValue`。
---
## zod 验证规则片段
```typescript
// 必填文本
{field}: z.string().min(1, '请输入{label}'),
// 必填文本 + 最大长度
{field}: z.string().min(1, '请输入{label}').max(50, '最多50个字符'),
// 必填数字(最小值)
{field}: z.number({ message: '请输入{label}' }).min(0.01, '最小值为0.01'),
// 必填选择(string)
{field}: z.string().min(1, '请选择{label}'),
// 必填选择(number)
{field}: z.number({ message: '请选择{label}' }),
// 布尔(开关,非必填)
{field}: z.boolean(),
// 数组(多选,非必填)
{field}: z.array(z.string()),
// 图片上传(string[],必填至少一张)
{field}: z.array(z.string()).min(1, '请上传{label}'),
// 非必填文本
{field}: z.string().optional(),
```
---
## 组件导入说明
Fantastic-admin 应用默认通过组件解析器自动导入 `Fa*` 组件,通常不需要手动 import。
只有目标应用未启用自动导入或组件解析器缺少对应组件时,才按该应用本地约定补充 import。
---
## 字段类型映射表
根据用户描述的关键词选择对应组件:
| 用户描述关键词 | 生成组件 | 备注 |
|---|---|---|
| 文本、名称、标题、账号、邮箱、手机 | `FaInput` | 默认文本输入 |
| 密码 | `FaInput type="password"` | 自动添加 FaPasswordStrength |
| 多行、描述、备注、内容、简介 | `FaTextarea` | |
| 下拉、选择、类型、分类、状态(枚举值) | `FaSelect` | 生成 options 数组占位 |
| 开关、启用、禁用、是否、boolean | `FaSwitch` | |
| 复选、多选 | `FaCheckbox`(多个) | 每个选项一个 FaCheckbox,手动维护数组 |
| 日期 | `FaInput type="date"` | |
| 日期时间 | `FaInput type="datetime-local"` | |
| 图片、头像、封面、缩略图 | `FaImageUpload` | |
| 文件、附件 | `FaFileUpload` | |
| 图标 | `FaIconPicker` | |
| 数字、金额、数量、年龄 | `FaNumberField` | |
字段类型不明确时,默认使用 `FaInput`。
@@ -1,43 +0,0 @@
---
name: fa-framework-settings
description: 管理和配置 Fantastic-admin 框架设置。当用户提到以下任何需求时必须使用此技能:开启/关闭水印、锁屏、错误日志、更新检查、哀悼模式、移动端访问;切换暗色/亮色/跟随系统主题;修改菜单模式(侧边栏/顶部/精简/面板);配置标签栏风格(fashion/card/square);启用/禁用工具栏功能(收藏夹、面包屑、搜索、通知、国际化、全屏、刷新);设置版权信息;配置认证/权限/登录过期;调整页面切换动画;配置居中布局;修改路由模式;以及任何涉及 src/settings/index.ts 的修改。
---
# 框架设置
## 第一步:确认工作区(必须阻塞等待用户回复)
本项目是 monorepo 架构,`apps/` 目录下存放各应用。**在执行任何文件读写操作之前**,必须先确认目标应用:
1. 执行 `ls apps/` 列出所有可用应用
2. **立即向用户提问**,明确询问要在哪个应用中修改设置,并**停止等待回复**
3. 收到用户明确回复后,才能继续后续步骤
> **严格规则**:如果用户没有在请求中明确说明目标应用(例如"在 example 应用中"、"apps/core"),则必须提问,不得自行猜测或默认选择任何应用。
确认后,后续所有文件路径均以该应用目录为根,例如 `apps/<app>/src/settings.ts`。
## 核心文件
- `apps/<app>/src/settings.ts` - 当前配置文件(修改此文件)
- `packages/settings/types.ts` - TypeScript 类型定义(只读参考)
- `packages/settings/src/default.ts` - 默认完整配置(禁止修改,仅供参考)
## 工作流程
1. 读取 `apps/<app>/src/settings.ts` 了解当前配置
2. 查阅 `packages/settings/types.ts` 中的类型定义了解可用选项
3. 查阅 `packages/settings/src/default.ts` 了解默认值
4. 仅修改 `apps/<app>/src/settings.ts`
5. 修改后检查:与默认值相同的配置项直接移除——`settings.ts` 只需保留真正自定义的内容,框架会自动继承默认配置,这样维护时一眼就能看出哪些是项目定制的
## 配置领域
详细配置选项请参考:
- **应用设置**: [references/app-settings.md](references/app-settings.md) - 认证、路由、功能开关、布局、主页、版权等
- **主题设置**: [references/theme-settings.md](references/theme-settings.md) - 颜色方案、主题同步、圆角、色弱模式等
- **导航菜单设置**: [references/menu-settings.md](references/menu-settings.md) - 导航菜单模式、风格、展开/收起行为、快捷键等
- **顶栏设置**: [references/topbar-settings.md](references/topbar-settings.md) - 标签栏、工具栏、显示模式等
- **标签栏设置**: [references/tabbar-settings.md](references/tabbar-settings.md) - 风格、图标、双击动作、记忆功能等
- **工具栏设置**: [references/toolbar-settings.md](references/toolbar-settings.md) - 收藏夹、面包屑、搜索、通知、国际化等
- **页面设置**: [references/page-settings.md](references/page-settings.md) - 快捷键、切换动画、进度条等
@@ -1,119 +0,0 @@
# 应用设置 (app)
## 目录
- [认证配置 (auth)](#认证配置-auth)
- [路由配置](#路由配置)
- [功能开关](#功能开关)
- [主页配置 (home)](#主页配置-home)
- [版权配置 (copyright)](#版权配置-copyright)
## 认证配置 (auth)
### permission
- **类型**: `boolean`
- **默认值**: `false`
- **说明**: 是否开启权限功能,控制是否启用权限验证功能
**示例:**
```typescript
app: {
auth: {
permission: true,
}
}
```
## 路由配置
### routeMode
- **类型**: `'hash' | 'html5'`
- **默认值**: `'hash'`
- **说明**: 设置应用的路由模式
- `'hash'` - Hash 模式
- `'html5'` - HTML5 模式
### routeBaseOn
- **类型**: `'frontend' | 'backend'
- **默认值**: `'frontend'`
- **说明**: 指定路由数据的来源方式
- `'frontend'` - 前端
- `'backend'` - 后端
## 功能开关
### dynamicTitle
- **类型**: `boolean`
- **默认值**: `false`
- **说明**: 控制是否启用动态页面标题功能
### rip
- **类型**: `boolean`
- **默认值**: `false`
- **说明**: 哀悼模式,开启后网站将会整体变灰
### mobile
- **类型**: `boolean`
- **默认值**: `true`
- **说明**: 移动端访问,关闭后网站将禁用移动端访问
## 主页配置 (home)
### enable
- **类型**: `boolean`
- **默认值**: `true`
- **说明**: 是否开启主页功能
### title
- **类型**: `string`
- **默认值**: `'主页'`
- **说明**: 主页的标题
### fullPath
- **类型**: `string`
- **默认值**: `'/'`
- **说明**: 主页的完整路由路径
**示例:**
```typescript
app: {
home: {
enable: true,
title: 'app.route.home',
fullPath: '/',
}
}
```
## 版权配置 (copyright)
### enable
- **类型**: `boolean`
- **默认值**: `false`
- **说明**: 是否开启版权信息显示,同时在路由 meta 对象里可以单独设置某个路由是否显示底部版权信息
### dates
- **类型**: `string`
- **默认值**: `''`
- **说明**: 网站运行日期
### company
- **类型**: `string`
- **默认值**: `''`
- **说明**: 版权信息中显示的公司名称
### website
- **类型**: `string`
- **默认值**: `''`
- **说明**: 版权信息中显示的网站地址
**示例:**
```typescript
app: {
copyright: {
enable: true,
dates: '2020-present',
company: 'Fantastic-admin',
website: 'https://fantastic-admin.hurui.me',
}
}
```
@@ -1,87 +0,0 @@
# 导航菜单设置 (menu)
## 目录
- [导航菜单模式 (mode)](#导航菜单模式-mode)
- [主导航点击模式 (mainMenuClickMode)](#主导航点击模式-mainmenuclickmode)
- [次导航展开行为](#次导航展开行为)
- [快捷键 (hotkeys)](#快捷键-hotkeys)
## 导航菜单模式 (mode)
- **类型**: `'side' | 'head' | 'single'`
- **默认值**: `'side'`
- **说明**: 设置导航菜单的显示模式
- `'side'` - 侧边栏模式(有主导航菜单)
- `'head'` - 顶部模式
- `'single'` - 侧边栏模式(无主导航菜单)
## 主导航菜单点击模式 (mainMenuClickMode)
- **类型**: `'switch' | 'jump' | 'smart'`
- **默认值**: `'switch'`
- **说明**: 设置主导航菜单项的点击行为
- `'switch'` - 切换
- `'jump'` - 跳转
- `'smart'` - 智能选择,判断次导航是否只有且只有一个可访问的菜单进行切换或跳转操作
## 次导航菜单展开行为
### subMenuUniqueExpand
- **类型**: `boolean`
- **默认值**: `true`
- **说明**: 次导航菜单是否只保持一个子项的展开
### subMenuCollapse
- **类型**: `boolean`
- **默认值**: `false`
- **说明**: 次导航菜单是否收起
### subMenuCollapseButton
- **类型**: `boolean`
- **默认值**: `false`
- **说明**: 是否开启次导航菜单的展开/收起按钮
## 快捷键 (hotkeys)
- **类型**: `boolean`
- **默认值**: `false`
- **说明**: 控制是否启用导航菜单相关的快捷键功能
## 完整示例
```typescript
menu: {
mode: 'side',
mainMenuClickMode: 'switch',
subMenuUniqueExpand: true,
subMenuCollapse: false,
subMenuCollapseButton: true,
hotkeys: true,
}
```
## 常见配置
**顶部导航菜单模式:**
```typescript
menu: {
mode: 'head',
}
```
**智能主导航菜单点击:**
```typescript
menu: {
mainMenuClickMode: 'smart',
}
```
**启用次导航菜单收起按钮:**
```typescript
menu: {
subMenuCollapseButton: true,
}
```
@@ -1,63 +0,0 @@
# 页面设置 (page)
## 目录
- [页面切换动画 (transitionMode)](#页面切换动画-transitionmode)
- [载入进度条 (progress)](#载入进度条-progress)
- [快捷键 (hotkeys)](#快捷键-hotkeys)
## 页面切换动画 (transitionMode)
- **类型**: `'' | 'fade' | 'slide-left' | 'slide-right' | 'slide-top' | 'slide-bottom'`
- **默认值**: `''`
- **说明**: 设置页面切换时的动画效果
- `''` - 无动画
- `'fade'` - 淡入淡出
- `'slide-left'` - 向左滑动
- `'slide-right'` - 向右滑动
- `'slide-top'` - 向上滑动
- `'slide-bottom'` - 向下滑动
## 载入进度条 (progress)
- **类型**: `boolean`
- **默认值**: `true`
- **说明**: 控制是否显示页面载入进度条
## 快捷键 (hotkeys)
- **类型**: `boolean`
- **默认值**: `true`
- **说明**: 控制是否启用页面相关的快捷键功能
## 完整示例
```typescript
page: {
transitionMode: 'fade',
progress: true,
hotkeys: true,
}
```
## 常见配置
**启用页面切换动画:**
```typescript
page: {
transitionMode: 'slide-right',
}
```
**禁用进度条:**
```typescript
page: {
progress: false,
}
```
**禁用快捷键:**
```typescript
page: {
hotkeys: false,
}
```
@@ -1,36 +0,0 @@
# 标签栏设置 (tabbar)
## 目录
- [显示图标 (icon)](#显示图标-icon)
- [双击执行动作 (dblclickAction)](#双击执行动作-dblclickaction)
- [快捷键 (hotkeys)](#快捷键-hotkeys)
## 显示图标 (icon)
- **类型**: `boolean`
- **默认值**: `false`
- **说明**: 控制标签是否显示图标
## 快捷键 (hotkeys)
- **类型**: `boolean`
- **默认值**: `false`
- **说明**: 控制是否启用标签栏相关的快捷键功能
## 完整示例
```typescript
tabbar: {
icon: true,
hotkeys: true,
}
```
## 常见配置
**显示图标:**
```typescript
tabbar: {
icon: true,
}
```
@@ -1,65 +0,0 @@
# 主题设置 (theme)
## 目录
- [颜色方案 (colorScheme)](#颜色方案-colorscheme)
- [圆角系数 (radius)](#圆角系数-radius)
- [色弱模式 (colorAmblyopia)](#色弱模式-coloramblyopia)
## 颜色方案 (colorScheme)
- **类型**: `'light' | 'dark' | ''`
- **默认值**: `'light'`
- **说明**: 设置应用的颜色方案
- `'light'` - 明亮模式
- `'dark'` - 暗黑模式
- `''` - 跟随系统
## 圆角系数 (radius)
- **类型**: `number`
- **默认值**: `0.5`
- **说明**: 设置界面元素的圆角大小,取值范围 0 到 1
- `0` - 无圆角(方形)
- `0.5` - 中等圆角
- `1` - 最大圆角
## 色弱模式 (colorAmblyopia)
- **类型**: `boolean`
- **默认值**: `false`
- **说明**: 启用色弱友好的颜色方案
## 完整示例
```typescript
theme: {
light: 'default',
dark: 'default',
colorScheme: 'light',
radius: 0.5,
colorAmblyopia: false,
}
```
## 常见配置
**启用暗色模式:**
```typescript
theme: {
colorScheme: 'dark',
}
```
**跟随系统颜色方案:**
```typescript
theme: {
colorScheme: '',
}
```
**调整圆角:**
```typescript
theme: {
radius: 0.8, // 更圆润的界面
}
```
@@ -1,82 +0,0 @@
# 工具栏设置 (toolbar)
## 目录
- [面包屑导航 (breadcrumb)](#面包屑导航-breadcrumb)
- [导航搜索 (menuSearch)](#导航搜索-menusearch)
- [全屏功能 (fullscreen)](#全屏功能-fullscreen)
- [页面刷新 (pageReload)](#页面刷新-pagereload)
- [颜色主题切换 (colorScheme)](#颜色主题切换-colorscheme)
## 面包屑导航 (breadcrumb)
- **类型**: `boolean`
- **默认值**: `true`
- **说明**: 控制是否显示面包屑导航
## 导航搜索 (menuSearch)
### enable
- **类型**: `boolean`
- **默认值**: `true`
- **说明**: 控制是否启用菜单搜索功能
### hotkeys
- **类型**: `boolean`
- **默认值**: `true`
- **说明**: 控制是否启用导航搜索的快捷键
**示例:**
```typescript
toolbar: {
menuSearch: {
enable: true,
hotkeys: true,
}
}
```
## 全屏功能 (fullscreen)
- **类型**: `boolean`
- **默认值**: `false`
- **说明**: 控制是否启用全屏切换功能
## 页面刷新 (pageReload)
- **类型**: `boolean`
- **默认值**: `false`
- **说明**: 控制是否启用页面刷新功能
## 颜色主题切换 (colorScheme)
- **类型**: `boolean`
- **默认值**: `false`
- **说明**: 控制是否启用颜色主题切换功能
## 完整示例
```typescript
toolbar: {
breadcrumb: true,
menuSearch: {
enable: true,
hotkeys: true,
},
fullscreen: true,
pageReload: true,
colorScheme: true,
}
```
## 常见配置
**启用所有工具栏功能:**
```typescript
toolbar: {
breadcrumb: true,
menuSearch: { enable: true },
fullscreen: true,
pageReload: true,
colorScheme: true,
}
```
@@ -1,61 +0,0 @@
# 顶栏设置 (topbar)
## 目录
- [标签栏 (tabbar)](#标签栏-tabbar)
- [工具栏 (toolbar)](#工具栏-toolbar)
- [顶栏模式 (mode)](#顶栏模式-mode)
## 标签栏 (tabbar)
- **类型**: `boolean`
- **默认值**: `false`
- **说明**: 控制是否在顶栏显示标签栏
## 工具栏 (toolbar)
- **类型**: `boolean`
- **默认值**: `false`
- **说明**: 控制是否在顶栏显示工具栏
## 顶栏模式 (mode)
- **类型**: `'static' | 'fixed' | 'sticky'`
- **默认值**: `'static'`
- **说明**: 设置顶栏的显示模式
- `'static'` - 静止,跟随页面滚动
- `'fixed'` - 固定,不跟随页面滚动,始终固定在顶部
- `'sticky'` - 粘性,页面往下滚动时隐藏,往上滚动时显示
## 完整示例
```typescript
topbar: {
tabbar: true,
toolbar: true,
mode: 'fixed',
}
```
## 常见配置
**启用标签栏和工具栏:**
```typescript
topbar: {
tabbar: true,
toolbar: true,
}
```
**固定顶栏:**
```typescript
topbar: {
mode: 'fixed',
}
```
**粘性顶栏(智能显示/隐藏):**
```typescript
topbar: {
mode: 'sticky',
}
```
-78
View File
@@ -1,78 +0,0 @@
---
name: fa-page-optimizer
description: "优化 Vue 页面,用 Fantastic-admin 框架内建组件(packages/components/)替换自定义实现和原生 HTML。当用户说:'帮我优化这个页面'、'把这些原生 HTML 换成框架组件'、'用 FaCard/FaModal/FaButton 重构一下'、'这个页面太乱了'、'统一一下 UI 风格'、'用内建组件替换自定义弹窗/分页/加载',即使用户只是说'看看这个页面能不能改进'也应触发此技能。"
---
# 页面优化器
利用 Fantastic-admin 的 70+ 内建组件优化 Vue 页面,用框架组件替换自定义实现,减少重复代码,保持 UI 一致性。
## 第一步:确认工作区(必须阻塞等待用户回复)
本项目是 monorepo 架构,`apps/` 目录下存放各应用。**在执行任何文件读写操作之前**,必须先确认目标应用:
1. 执行 `ls apps/` 列出所有可用应用
2. **立即向用户提问**,明确询问要优化哪个应用中的页面,并**停止等待回复**
3. 收到用户明确回复后,才能继续后续步骤
> **严格规则**:如果用户没有在请求中明确说明目标应用(例如"在 example 应用中"、"apps/core"),则必须提问,不得自行猜测或默认选择任何应用。
确认后,后续所有页面路径均在 `apps/<app>/src/views/` 下。
## 优化工作流
### 步骤 1: 分析页面,识别替换机会
读取目标页面,找出三类可优化点:
- **原生 HTML 元素**:`<button>`、`<input>`、`<select>`、自定义卡片 div 等
- **重复造轮子的自定义组件**:自定义弹窗、分页、加载状态、提示消息等
- **可简化的内联逻辑**:手动标签页切换、手动状态管理等
### 步骤 2: 查找合适的框架组件
先查组件目录确认有哪些可用组件:
```
Read: references/components-catalog.md
```
确定组件后,读取对应 README 了解完整 API(props、slots、events):
```
Read: packages/components/src/<component-name>/README.md
```
README 是最权威的用法来源,不确定时优先看文档而不是猜。
### 步骤 3: 参考优化模式(可选)
如果不确定如何替换,查看前后对比示例:
```
Read: references/optimization-patterns.md
```
### 步骤 4: 实施替换
替换时保留所有原始功能,不要改变业务逻辑。框架组件通常提供组合式函数用于编程式控制,优先使用:
- `useFaModal()` — 编程式打开/关闭弹窗、confirm 确认框
- `useFaToast()` — 显示成功/错误提示
- `useFaLoading()` — 控制加载遮罩
组件可以组合使用,例如:
```vue
<FaCard title="用户列表">
<FaSearchBar v-model="keyword" />
<FaEmpty v-if="users.length === 0" />
<template #footer>
<FaPagination :page="page" :size="size" :total="total" />
</template>
</FaCard>
```
### 步骤 5: 验证
Fa 组件通过 `unplugin-auto-import` 自动导入,无需手动写 import 语句。替换后确认 props 和 v-model 绑定符合组件 API。如有问题,回到 `packages/components/src/<component-name>/README.md` 核对。
@@ -1,286 +0,0 @@
# Fantastic Admin 内建组件目录
本文档列出所有可用的框架内建组件及其使用场景。组件位于 `packages/components/src/`。
> **提示**: 每个组件目录下都有 `README.md` 使用文档,包含完整的 API 说明 (Props/Slots/Events/Methods) 和示例代码。
> 查阅方式:`Read: packages/components/src/<component-name>/README.md`
## 基础组件
### FaButton
**用途**: 按钮组件,支持多种样式和状态
**变体**: default, destructive, outline, secondary, ghost, link
**特性**: loading 状态、disabled 状态
### FaIcon
**用途**: 图标组件,基于 [iconify](https://icon-sets.iconify.design/)
**示例**: <FaIcon name="i-mdi:home" />
### FaKbd / FaKbdGroup
**用途**: 键盘按键显示组件
### FaLabel
**用途**: 表单标签组件
## 布局组件
### FaCard
**用途**: 卡片容器,支持标题、描述、内容、底部插槽
**特性**: title, description, footer slot
### FaDivider
**用途**: 分割线组件
### FaPageHeader
**用途**: 页面头部组件
### FaPageMain
**用途**: 页面主体容器
### FaScrollArea
**用途**: 滚动区域容器
### FaScrollingText
**用途**: 滚动文字特效
## 表单组件
### FaInput
**用途**: 输入框组件,支持 v-model
**特性**: placeholder, disabled 等标准输入属性
### FaTextarea
**用途**: 多行文本输入
### FaCheckbox
**用途**: 复选框组件
### FaSwitch
**用途**: 开关切换组件
### FaSelect
**用途**: 下拉选择组件
### FaSlider
**用途**: 滑块组件
### FaNumberField
**用途**: 数字输入组件
### FaInputOTP
**用途**: OTP 验证码输入组件
### FaPasswordStrength
**用途**: 密码强度显示组件
### FaFileUpload
**用途**: 文件上传组件
### FaImageUpload
**用途**: 图片上传组件
### FaIconPicker
**用途**: 图标选择器
### FaSearchBar
**用途**: 搜索栏组件
### FaCascader
**用途**: 级联选择组件,支持多级树形数据选择
## 交互组件
### FaModal
**用途**: 模态对话框,支持拖拽、最大化等功能
**特性**: maximizable, closable, draggable, alignCenter, loading, before-close
**API**: useFaModal() 用于编程式调用
### FaDrawer
**用途**: 抽屉组件
### FaDropdown
**用途**: 下拉菜单
### FaContextMenu
**用途**: 右键上下文菜单
### FaPopover
**用途**: 弹出框组件
### FaTooltip
**用途**: 工具提示
### FaHoverCard
**用途**: 悬停卡片
### FaCollapsible
**用途**: 可折叠容器
## 反馈组件
### FaToast
**用途**: 轻提示组件
### FaLoading
**用途**: 加载状态组件
### FaProgress
**用途**: 进度条组件
### FaEmpty
**用途**: 空状态组件
## 数据展示组件
### FaTabs
**用途**: 标签页组件
### FaTimeline
**用途**: 时间轴组件
### FaTree
**用途**: 树形组件
### FaPagination
**用途**: 分页组件
**特性**: page, size, total
### FaAvatar
**用途**: 头像组件
### FaCarousel
**用途**: 轮播图组件
### FaImagePreview
**用途**: 图片预览组件
## 数据可视化组件
### FaSparkline
**用途**: 迷你图表组件
### FaTrend
**用途**: 趋势指示器
### FaCountTo
**用途**: 数字动画组件
### FaAnimatedCountTo
**用途**: 动画数字组件
### FaAnimatedCountToGroup
**用途**: 动画数字组组件
## 特效组件
### FaBorderBeam
**用途**: 边框光束特效
### FaGlowyCard / FaGlowyCardWrapper
**用途**: 发光卡片特效
### FaSpotlightCard
**用途**: 聚光灯卡片特效
### FaParticlesBg
**用途**: 粒子背景特效
### FaPatternBg
**用途**: 图案背景
### FaBlurReveal
**用途**: 模糊揭示特效
### FaAnimatedBeam
**用途**: 动画光束特效
### FaFlipCard
**用途**: 翻转卡片
### FaFlipWords
**用途**: 翻转文字特效
### FaSparklesText
**用途**: 闪光文字特效
### FaTextHighlight
**用途**: 文字高亮特效
### FaMarquee
**用途**: 跑马灯组件
### FaSmoothSwipe
**用途**: 平滑滑动组件
## 高级组件
### FaButtonGroup
**用途**: 按钮组组件
### FaGradientButton
**用途**: 渐变按钮
### FaInteractiveButton
**用途**: 交互式按钮
### FaDigitalCard
**用途**: 数字卡片
### FaMultiStepLoader
**用途**: 多步骤加载器
### FaLinkPreview
**用途**: 链接预览组件
### FaTimeAgo
**用途**: 相对时间显示
### FaCode
**用途**: 代码展示组件
### FaCodePreview
**用途**: 代码预览组件
### FaQrcode
**用途**: 二维码生成组件
### FaStorageBox
**用途**: 存储盒组件
### FaScratchOff
**用途**: 刮刮卡组件
### FaBackToTop
**用途**: 返回顶部按钮
### FaFixedBar
**用途**: 固定栏组件
## 组件选择指南
### 替换原生 HTML 元素
| 原生元素 | 推荐组件 | 说明 |
|---------|---------|------|
| `<button>` | `FaButton` | 统一的按钮样式和状态管理 |
| `<input>` | `FaInput` | 统一的输入框样式 |
| `<textarea>` | `FaTextarea` | 统一的多行输入样式 |
| `<select>` | `FaSelect` | 更好的下拉选择体验 |
| `<div class="card">` | `FaCard` | 标准化的卡片布局 |
| `<hr>` | `FaDivider` | 统一的分割线样式 |
| `<img>` (头像) | `FaAvatar` | 头像专用组件 |
### 替换常见功能实现
| 功能 | 推荐组件 | 说明 |
|------|---------|------|
| 模态对话框 | `FaModal` | 替代自定义 modal 实现 |
| 分页逻辑 | `FaPagination` | 替代自定义分页组件 |
| 加载状态 | `FaLoading` | 替代自定义 loading 动画 |
| 空状态提示 | `FaEmpty` | 替代自定义空状态页面 |
| 消息提示 | `FaToast` | 替代 alert 或自定义提示 |
| 标签页切换 | `FaTabs` | 替代自定义 tab 实现 |
| 树形数据 | `FaTree` | 替代自定义树形组件 |
| 图片预览 | `FaImagePreview` | 替代自定义图片查看器 |
| 搜索框 | `FaSearchBar` | 替代普通 input + 搜索逻辑 |
| 级联选择 | `FaCascader` | 替代自定义多级联动下拉选择 |
@@ -1,604 +0,0 @@
# 页面优化模式
本文档展示如何用框架内建组件替换常见的自定义代码和原生 HTML 实现。
## 基础元素替换
### 按钮优化
**优化前**:
```vue
<button class="btn btn-primary" @click="handleClick">
提交
</button>
<button class="custom-button" :disabled="loading">
<span v-if="loading">加载中...</span>
<span v-else>提交</span>
</button>
```
**优化后**:
```vue
<FaButton @click="handleClick">
提交
</FaButton>
<FaButton :loading="loading">
提交
</FaButton>
```
### 输入框优化
**优化前**:
```vue
<div class="form-group">
<input
v-model="username"
type="text"
class="form-control"
placeholder="请输入用户名"
>
</div>
```
**优化后**:
```vue
<FaInput v-model="username" placeholder="请输入用户名" />
```
### 卡片容器优化
**优化前**:
```vue
<div class="card">
<div class="card-header">
<h3>卡片标题</h3>
<p class="text-muted">卡片描述</p>
</div>
<div class="card-body">
卡片内容
</div>
<div class="card-footer">
底部内容
</div>
</div>
```
**优化后**:
```vue
<FaCard title="卡片标题" description="卡片描述">
卡片内容
<template #footer>
底部内容
</template>
</FaCard>
```
## 交互组件替换
### 模态对话框优化
**优化前**:
```vue
<script setup>
const visible = ref(false)
const title = ref('')
const content = ref('')
function handleClose() {
visible.value = false
}
function handleConfirm() {
// 确认逻辑
visible.value = false
}
</script>
<template>
<div v-if="visible" class="modal-overlay" @click="handleClose">
<div class="modal-content" @click.stop>
<div class="modal-header">
<h3>{{ title }}</h3>
<button class="close-btn" @click="handleClose">
×
</button>
</div>
<div class="modal-body">
{{ content }}
</div>
<div class="modal-footer">
<button @click="handleClose">
取消
</button>
<button @click="handleConfirm">
确定
</button>
</div>
</div>
</div>
</template>
<style scoped>
.modal-overlay {
position: fixed;
top: 0;
left: 0;
right: 0;
bottom: 0;
background: rgba(0, 0, 0, 0.5);
display: flex;
align-items: center;
justify-content: center;
}
/* 更多样式... */
</style>
```
**优化后**:
```vue
<script setup>
const modal = ref(false)
</script>
<template>
<FaButton @click="modal = true">
打开对话框
</FaButton>
<FaModal v-model="modal" title="标题">
内容
</FaModal>
</template>
```
### 分页组件优化
**优化前**:
```vue
<script setup>
const page = ref(1)
const size = ref(10)
const total = ref(100)
const totalPages = computed(() => Math.ceil(total.value / size.value))
</script>
<template>
<div class="pagination">
<button :disabled="page === 1" @click="page--">
上一页
</button>
<span>{{ page }} / {{ totalPages }}</span>
<button :disabled="page === totalPages" @click="page++">
下一页
</button>
</div>
</template>
```
**优化后**:
```vue
<FaPagination :page="page" :size="size" :total="total" />
<script setup>
const page = ref(1)
const size = ref(10)
const total = ref(100)
</script>
```
## 反馈组件替换
### 加载状态优化
**优化前**:
```vue
<div v-if="loading" class="loading-overlay">
<div class="spinner">
</div>
<p>
加载中...
</p>
</div>
<style scoped>
.loading-overlay {
position: fixed;
top: 0;
left: 0;
right: 0;
bottom: 0;
background: rgba(255, 255, 255, 0.8);
display: flex;
align-items: center;
justify-content: center;
}
.spinner {
/* 自定义动画 */
}
</style>
```
**优化后**:
```vue
<script setup>
import { useFaLoading } from '@/ui/components/FaLoading'
async function fetchData() {
const { close } = useFaLoading()
try {
await api.getData()
}
finally {
close()
}
}
</script>
```
### 空状态优化
**优化前**:
```vue
<div v-if="list.length === 0" class="empty-state">
<img src="/empty.png" alt="空状态">
<p>暂无数据</p>
</div>
```
**优化后**:
```vue
<FaEmpty v-if="list.length === 0" description="暂无数据" />
```
### 消息提示优化
**优化前**:
```vue
<script setup>
function showMessage(message: string) {
alert(message)
}
// 或自定义实现
const messages = ref<string[]>([])
function showMessage(message: string) {
messages.value.push(message)
setTimeout(() => {
messages.value.shift()
}, 3000)
}
</script>
```
**优化后**:
```vue
<script setup>
import { useFaToast } from '@/ui/components/FaToast'
const toast = useFaToast()
function showMessage(message: string) {
toast.success(message)
}
</script>
```
## 表单组件替换
### 复选框优化
**优化前**:
```vue
<label class="checkbox-wrapper">
<input v-model="checked" type="checkbox">
<span>同意协议</span>
</label>
```
**优化后**:
```vue
<FaCheckbox v-model="checked">
同意协议
</FaCheckbox>
```
### 开关优化
**优化前**:
```vue
<div class="switch-wrapper">
<input
v-model="enabled"
type="checkbox"
class="switch-input"
>
<span class="switch-slider"></span>
</div>
<style scoped>
.switch-wrapper {
/* 自定义开关样式 */
}
</style>
```
**优化后**:
```vue
<FaSwitch v-model="enabled" />
```
### 下拉选择优化
**优化前**:
```vue
<select v-model="selected" class="form-select">
<option value="">请选择</option>
<option v-for="item in options" :key="item.value" :value="item.value">
{{ item.label }}
</option>
</select>
```
**优化后**:
```vue
<FaSelect v-model="selected" :options="options" placeholder="请选择" />
```
### 级联选择优化
**优化前**:
```vue
<script setup>
// 自定义多级联动下拉:需要手动管理每一层的选中状态
const province = ref('')
const city = ref('')
const district = ref('')
const cities = computed(() => getCities(province.value))
const districts = computed(() => getDistricts(city.value))
</script>
<template>
<select v-model="province">
<option v-for="p in provinces" :key="p.value" :value="p.value">{{ p.label }}</option>
</select>
<select v-model="city" :disabled="!province">
<option v-for="c in cities" :key="c.value" :value="c.value">{{ c.label }}</option>
</select>
<select v-model="district" :disabled="!city">
<option v-for="d in districts" :key="d.value" :value="d.value">{{ d.label }}</option>
</select>
</template>
```
**优化后**:
```vue
<script setup>
const selected = ref<string | undefined>()
const options = [
{
label: '浙江省', value: 'zj',
children: [
{
label: '杭州市', value: 'hz',
children: [
{ label: '西湖区', value: 'xh' },
{ label: '余杭区', value: 'yh' },
],
},
],
},
]
</script>
<template>
<FaCascader v-model="selected" :options="options" placeholder="请选择地区" clearable />
</template>
```
## 数据展示优化
### 标签页优化
**优化前**:
```vue
<script setup>
const activeTab = ref('tab1')
const tabs = [
{ key: 'tab1', label: '标签1' },
{ key: 'tab2', label: '标签2' },
]
</script>
<template>
<div class="tabs">
<div class="tab-headers">
<div
v-for="tab in tabs"
:key="tab.key"
:class="{ active: activeTab === tab.key }"
@click="activeTab = tab.key"
>
{{ tab.label }}
</div>
</div>
<div class="tab-content">
<div v-if="activeTab === 'tab1'">
内容1
</div>
<div v-if="activeTab === 'tab2'">
内容2
</div>
</div>
</div>
</template>
```
**优化后**:
```vue
<FaTabs v-model="activeTab" :tabs="tabs">
<template #tab1>内容1</template>
<template #tab2>内容2</template>
</FaTabs>
<script setup>
const activeTab = ref('tab1')
const tabs = [
{ key: 'tab1', label: '标签1' },
{ key: 'tab2', label: '标签2' },
]
</script>
```
### 头像显示优化
**优化前**:
```vue
<div class="avatar">
<img v-if="user.avatar" :src="user.avatar" alt="头像">
<span v-else class="avatar-fallback">{{ user.name[0] }}</span>
</div>
<style scoped>
.avatar {
width: 40px;
height: 40px;
border-radius: 50%;
overflow: hidden;
}
</style>
```
**优化后**:
```vue
<FaAvatar :src="user.avatar" :alt="user.name" />
```
## 特效组件应用
### 卡片特效增强
**优化前**:
```vue
<div class="card">
<!-- 普通卡片 -->
</div>
```
**优化后**:
```vue
<!-- 添加发光效果 -->
<FaGlowyCard>
<!-- 卡片内容 -->
</FaGlowyCard>
<!-- 添加聚光灯效果 -->
<FaSpotlightCard>
<!-- 卡片内容 -->
</FaSpotlightCard>
<!-- 添加边框光束 -->
<FaCard>
<FaBorderBeam />
<!-- 卡片内容 -->
</FaCard>
```
### 文字特效增强
**优化前**:
```vue
<h1 class="title">
欢迎使用
</h1>
```
**优化后**:
```vue
<!-- 添加闪光效果 -->
<FaSparklesText text="欢迎使用" />
<!-- 添加高亮效果 -->
<FaTextHighlight>
欢迎使用
</FaTextHighlight>
<!-- 添加翻转效果 -->
<FaFlipWords :words="['欢迎', 'Welcome', 'Bienvenue']" />
```
## 布局优化
### 页面结构优化
**优化前**:
```vue
<template>
<div class="page">
<div class="page-header">
<h1>页面标题</h1>
<div class="actions">
<button>操作</button>
</div>
</div>
<div class="page-content">
<!-- 内容 -->
</div>
</div>
</template>
<style scoped>
.page {
padding: 20px;
}
.page-header {
display: flex;
justify-content: space-between;
margin-bottom: 20px;
}
</style>
```
**优化后**:
```vue
<template>
<FaPageHeader title="页面标题">
<template #actions>
<FaButton>操作</FaButton>
</template>
</FaPageHeader>
<FaPageMain>
<!-- 内容 -->
</FaPageMain>
</template>
```
## 优化原则
1. **优先使用框架组件**: 检查 `src/ui/components/` 是否有对应的内建组件
2. **参考组件源码**: 查看组件实现了解使用方式和 API
3. **保持功能一致**: 确保替换后的组件功能与原代码一致
4. **简化代码**: 移除不必要的自定义样式和逻辑
5. **统一风格**: 使用框架组件可以保持整个应用的视觉一致性
6. **提升可维护性**: 框架组件有统一的 API 和文档,更易维护
## 常见场景映射
| 场景 | 原实现 | 框架组件 |
| ---------- | ---------------------- | ----------------------------- |
| 用户列表 | 自定义表格 + 分页 | FaCard + FaPagination |
| 表单提交 | 原生 form + input | FaInput + FaButton + FaModal |
| 数据加载 | 自定义 loading | FaLoading |
| 错误提示 | alert / 自定义 toast | FaToast |
| 确认对话框 | confirm / 自定义 modal | FaModal (useFaModal) |
| 图片上传 | 自定义上传组件 | FaImageUpload |
| 搜索功能 | input + 搜索逻辑 | FaSearchBar |
| 级联选择 | 多级联动 select | FaCascader |
| 数据统计 | 自定义数字展示 | FaCountTo / FaAnimatedCountTo |
| 趋势展示 | 自定义图表 | FaSparkline + FaTrend |
| 时间显示 | 自定义格式化 | FaTimeAgo |
-108
View File
@@ -1,108 +0,0 @@
---
name: fa-route-generator
description: 管理 Vue Router 路由配置,用于 Fantastic-admin 框架。当用户提到以下任何需求时必须使用此技能:新建页面需要加路由、详情页不想显示在菜单里、新增页和编辑页老是开两个标签、从列表跳详情返回后状态丢失、给菜单项加 NEW 标签或红点、路由需要权限控制、配置页面保活、修改路由 meta、添加面包屑配置。即使用户只是说"加个路由"或"新建了一个页面",也应触发此技能。
---
# 路由生成器
框架通过路由自动生成导航菜单,路由配置需要遵循特定约定。
## 第一步:确认工作区(必须阻塞等待用户回复)
本项目是 monorepo 架构,`apps/` 目录下存放各应用。**在执行任何文件读写操作之前**,必须先确认目标应用:
1. 执行 `ls apps/` 列出所有可用应用
2. **立即向用户提问**,明确询问要在哪个应用中操作路由,并**停止等待回复**
3. 收到用户明确回复后,才能继续后续步骤
> **严格规则**:如果用户没有在请求中明确说明目标应用(例如"在 example 应用中"、"apps/core"),则必须提问,不得自行猜测或默认选择任何应用。
确认后,后续所有文件路径均以该应用目录为根,例如 `apps/<app>/src/router/`。
## 前置检查
读取 `apps/<app>/src/settings.ts`,检查 `app.routeBaseOn` 的值:
- `'frontend'`(默认):可以继续
- `'backend'`:路由由后端驱动,手动创建的路由文件会被忽略,告知用户此模式不支持前端路由文件生成
## 工作流程
### 场景 A: 创建新路由
#### 1. 收集路由信息
向用户询问或确认:路由路径、页面标题、图标(可选)、是否多级路由、所属主导航分组。
#### 2. 创建路由文件
在 `apps/<app>/src/router/modules/` 下创建 `<模块名>.ts`:
```typescript
import type { RouteRecordRaw } from 'vue-router'
function Layout() {
return import('@/layouts/index.vue')
}
const routes: RouteRecordRaw = {
path: '/example',
component: Layout,
name: 'example',
meta: {
title: '示例',
icon: 'i-ep:menu',
},
children: [
{
path: '',
name: 'exampleIndex',
component: () => import('@/views/example/index.vue'),
meta: {
title: '示例页面',
},
},
],
}
export default routes
```
#### 3. 更新 routes.ts
在 `apps/<app>/src/router/routes.ts` 中添加 import 并注册到对应主导航分组的 `children` 数组。
### 场景 B: 修改现有路由
定位路由文件(在 `apps/<app>/src/router/modules/` 下搜索),读取后按需修改 meta 属性。常见修改:
**权限控制**:
```typescript
meta: { auth: 'user:view' } // 或数组 ['user:view', 'user:edit']
```
**页面保活**(从详情返回列表时保留列表状态):
```typescript
// 列表页
meta: { keepAlive: ['productDetail'] }
// 详情页
meta: { menu: false, activeMenu: '/product', noKeepAlive: 'productList' }
```
**隐藏菜单项**:
```typescript
meta: { menu: false, activeMenu: '/parent/path' }
```
## 框架约定
- 一级路由 `path` 必须以 `/` 开头,`component` 必须是 `Layout`
- 子路由 `path` 不要以 `/` 开头
- 多级路由的中间层级无需设置 `component`
- 所有路由的 `name` 必须全局唯一
## Meta 属性配置
详细属性说明见 [references/route-meta.md](references/route-meta.md),更多示例见 [references/examples.md](references/examples.md)。
常用属性:`title`(必需)、`icon`、`menu`、`auth`、`keepAlive`、`activeMenu`、`breadcrumb`
@@ -1,459 +0,0 @@
# 路由配置示例
本文档提供了各种常见场景的路由配置示例,包括创建新路由和修改现有路由。
## 目录
- [基础示例](#基础示例)
- [多级路由](#多级路由)
- [特殊场景](#特殊场景)
- [路由配置调整](#路由配置调整)
- [完整示例](#完整示例)
## 基础示例
### 单页面路由
最简单的单页面路由配置:
```typescript
import type { RouteRecordRaw } from 'vue-router'
function Layout() {
return import('@/layouts/index.vue')
}
const routes: RouteRecordRaw = {
path: '/dashboard',
component: Layout,
name: 'dashboard',
meta: {
title: '仪表盘',
icon: 'i-ep:data-line',
},
children: [
{
path: '',
name: 'dashboardIndex',
component: () => import('@/views/dashboard/index.vue'),
meta: {
title: '数据概览',
},
},
],
}
export default routes
```
### 列表-详情路由
常见的列表和详情页面配置:
```typescript
const routes: RouteRecordRaw = {
path: '/article',
component: Layout,
name: 'article',
meta: {
title: '文章管理',
icon: 'i-ep:document',
},
children: [
{
path: '',
name: 'articleList',
component: () => import('@/views/article/list.vue'),
meta: {
title: '文章列表',
keepAlive: 'articleDetail', // 从详情返回时保持列表状态
},
},
{
path: 'detail/:id?',
name: 'articleDetail',
component: () => import('@/views/article/detail.vue'),
meta: {
title: '文章详情',
menu: false, // 不在导航中显示
activeMenu: '/article', // 高亮文章管理菜单
keepAlive: true,
noKeepAlive: 'articleList', // 从列表进入时不保活
},
},
],
}
```
## 多级路由
### 二级菜单
```typescript
const routes: RouteRecordRaw = {
path: '/system',
component: Layout,
name: 'system',
meta: {
title: '系统管理',
icon: 'i-ep:setting',
},
children: [
{
path: 'user',
name: 'systemUser',
component: () => import('@/views/system/user/index.vue'),
meta: {
title: '用户管理',
icon: 'i-ep:user',
},
},
{
path: 'role',
name: 'systemRole',
component: () => import('@/views/system/role/index.vue'),
meta: {
title: '角色管理',
icon: 'i-ep:avatar',
},
},
{
path: 'permission',
name: 'systemPermission',
component: () => import('@/views/system/permission/index.vue'),
meta: {
title: '权限管理',
icon: 'i-ep:lock',
},
},
],
}
```
### 三级菜单
```typescript
const routes: RouteRecordRaw = {
path: '/content',
component: Layout,
name: 'content',
meta: {
title: '内容管理',
icon: 'i-ep:folder',
},
children: [
{
path: 'article',
name: 'contentArticle',
meta: {
title: '文章管理',
icon: 'i-ep:document',
},
// 注意: 多级路由的中间层级不需要设置 component
children: [
{
path: 'list',
name: 'contentArticleList',
component: () => import('@/views/content/article/list.vue'),
meta: {
title: '文章列表',
},
},
{
path: 'category',
name: 'contentArticleCategory',
component: () => import('@/views/content/article/category.vue'),
meta: {
title: '文章分类',
},
},
],
},
{
path: 'media',
name: 'contentMedia',
meta: {
title: '媒体管理',
icon: 'i-ep:picture',
},
children: [
{
path: 'image',
name: 'contentMediaImage',
component: () => import('@/views/content/media/image.vue'),
meta: {
title: '图片管理',
},
},
{
path: 'video',
name: 'contentMediaVideo',
component: () => import('@/views/content/media/video.vue'),
meta: {
title: '视频管理',
},
},
],
},
],
}
```
## 特殊场景
### 带权限的路由
```typescript
const routes: RouteRecordRaw = {
path: '/admin',
component: Layout,
name: 'admin',
meta: {
title: '管理员',
icon: 'i-ep:user-filled',
auth: 'admin', // 需要 admin 权限
},
children: [
{
path: 'users',
name: 'adminUsers',
component: () => import('@/views/admin/users.vue'),
meta: {
title: '用户列表',
auth: ['admin:view', 'admin:edit'], // 需要其中一个权限
},
},
],
}
```
### 外部链接
```typescript
const routes: RouteRecordRaw = {
path: '/external',
component: Layout,
name: 'external',
meta: {
title: '外部链接',
icon: 'i-ep:link',
},
children: [
{
path: 'github',
name: 'externalGithub',
component: () => import('@/views/external/link.vue'),
meta: {
title: 'GitHub',
link: 'https://github.com',
},
},
],
}
```
### 默认展开的路由
```typescript
const routes: RouteRecordRaw = {
path: '/menu',
component: Layout,
name: 'menu',
meta: {
title: '菜单示例',
icon: 'i-ep:menu',
expand: true, // 默认展开
},
children: [
{
path: 'always',
name: 'menuAlways',
meta: {
title: '默认展开',
expand: true,
},
children: [
{
path: 'item1',
name: 'menuAlwaysItem1',
component: () => import('@/views/menu/item1.vue'),
meta: {
title: '菜单项 1',
},
},
],
},
],
}
```
## 路由配置调整
### 权限配置调整
**场景 1: 添加单个权限**
```typescript
// 修改前
meta: {
title: '用户管理',
}
// 修改后
meta: {
title: '用户管理',
auth: 'user:view', // 需要 user:view 权限
}
```
**场景 2: 添加多个权限(或关系)**
```typescript
meta: {
title: '用户管理',
auth: ['user:view', 'user:edit'], // 满足其中一个即可
}
```
### 页面保活配置
**场景 1: 列表页保活配置**
列表页需要在从详情页返回时保持状态。
```typescript
{
path: '',
name: 'orderList',
component: () => import('@/views/order/list.vue'),
meta: {
title: '订单列表',
keepAlive: ['orderDetail', 'orderEdit'], // 从这些页面返回时保活
},
}
```
**场景 2: 详情页保活配置**
详情页需要保活,但从列表页进入时不保活(确保显示最新数据)。
```typescript
{
path: 'detail/:id',
name: 'orderDetail',
component: () => import('@/views/order/detail.vue'),
meta: {
title: '订单详情',
menu: false,
activeMenu: '/order',
keepAlive: true, // 始终保活
noKeepAlive: 'orderList', // 从列表进入时不保活
},
}
```
**场景 3: 取消保活**
某些页面不需要保活,每次进入都重新加载。
```typescript
// 删除或注释掉 keepAlive 相关配置
meta: {
title: '实时数据',
// keepAlive: true, // 删除此行
}
```
### 导航显示调整
**场景 1: 隐藏导航项**
某些页面不需要在导航菜单中显示。
```typescript
meta: {
title: '个人设置',
menu: false, // 不在导航中显示
activeMenu: '/user', // 但高亮用户菜单
}
```
### 面包屑配置
**场景 1: 隐藏面包屑**
某些页面不需要显示面包屑。
```typescript
meta: {
title: '登录',
breadcrumb: false, // 不显示面包屑
}
```
**场景 2: 自定义面包屑高亮**
```typescript
meta: {
title: '编辑文章',
activeMenu: '/article/list', // 面包屑高亮到文章列表
}
```
### 外部链接配置
**场景 1: 在新窗口打开外部链接**
```typescript
{
path: 'github',
name: 'externalGithub',
component: () => import('@/views/external/link.vue'),
meta: {
title: 'GitHub',
link: 'https://github.com', // 在新窗口打开
},
}
```
## 在 routes.ts 中的使用
```typescript
import ArticleRoute from './modules/article'
import ContentRoute from './modules/content'
// 1. 导入路由模块
import DashboardRoute from './modules/dashboard'
import SystemRoute from './modules/system'
// 2. 添加到 asyncRoutes
const asyncRoutes: Route.recordMainRaw[] = [
{
meta: {
title: '工作台',
icon: 'i-ep:monitor',
},
children: [
DashboardRoute,
],
},
{
meta: {
title: '内容',
icon: 'i-ep:document',
},
children: [
ArticleRoute,
ContentRoute,
],
},
{
meta: {
title: '系统',
icon: 'i-ep:setting',
},
children: [
SystemRoute,
],
},
]
```
@@ -1,115 +0,0 @@
# RouteMetaRaw 类型属性说明
本文档详细说明了 Fantastic-admin 框架中路由 meta 对象的所有可用属性。
## 目录
- [权限相关](#权限相关)
- [导航显示](#导航显示)
- [标签页](#标签页)
- [页面行为](#页面行为)
- [布局](#布局)
- [其他](#其他)
## 权限相关
### auth
- **类型**: `string | string[]`
- **默认值**: `undefined`
- **说明**: 路由访问权限,配置为数组时,只需满足一个即可进入
- **示例**:
```typescript
auth: 'news:view' // 需要具备 news:view 权限
auth: ['news:view', 'news:edit'] // 需要具备其中一个权限
```
## 导航显示
### title
- **类型**: `string | (() => string)`
- **默认值**: `undefined`
- **说明**: 标题会在导航、标签页、面包屑等需要的展示位置显示
- **示例**:
```typescript
title: '新闻管理'
title: () => '动态标题'
```
### icon
- **类型**: `string`
- **默认值**: `undefined`
- **说明**: 图标
- **示例**:
```typescript
icon: 'i-ep:lock' // 默认显示 i-ep:lock 图标
```
### menu
- **类型**: `boolean`
- **默认值**: `true`
- **说明**: 是否在导航中显示,当子导航里没有可展示的导航时,会直接显示父导航
### activeMenu
- **类型**: `string`
- **默认值**: `undefined`
- **说明**: 高亮导航,需要设置完整路由地址
- **示例**:
```typescript
activeMenu: '/news/list'
```
### expand
- **类型**: `boolean`
- **默认值**: `undefined`
- **说明**: 是否默认展开
- **示例**:
```typescript
expand: true // 默认展开
```
### breadcrumb
- **类型**: `boolean`
- **默认值**: `true`
- **说明**: 是否在面包屑中显示
## 页面行为
### keepAlive
- **类型**: `boolean | string | string[]`
- **默认值**: `undefined`
- **说明**: 保活,根据规则保活当前路由页面
- **示例**:
```typescript
keepAlive: true // 始终保活
keepAlive: 'news' // 访问路由name为news的页面时保活
keepAlive: ['news', 'user'] // 访问路由name为news或user的页面时保活
```
### noKeepAlive
- **类型**: `string | string[]`
- **默认值**: `undefined`
- **说明**: 不保活,根据规则不保活当前路由页面
- **示例**:
```typescript
noKeepAlive: 'news' // 访问路由name为news的页面时不保活
noKeepAlive: ['news', 'user'] // 访问路由name为news或user的页面时不保活
```
### link
- **类型**: `string`
- **默认值**: `undefined`
- **说明**: 外部链接,会在浏览器新窗口访问该链接
- **示例**:
```typescript
link: 'https://fantastic-admin.hurui.me' // 在浏览器新窗口打开 Fantastic-admin 官网
```
-102
View File
@@ -1,102 +0,0 @@
---
name: fa-slot-creator
description: 在 Fantastic-admin 框架中创建插槽,向布局的任意位置注入自定义内容。当用户提到以下任何需求时必须使用此技能:在头部/侧边栏/工具栏/标签栏加东西、logo 旁边加内容、侧边栏底部加用户信息、加个悬浮按钮、在导航菜单右侧加自定义组件、想在框架布局某个区域插入内容、在页面顶部或底部插入全局横幅/公告/版权栏。即使用户只是说"在顶部加个 XX"或"侧边栏加点东西",也应触发此技能。支持 19 个插槽位置。
---
# Fantastic-admin 插槽创建器
框架通过约定自动发现插槽:目录名必须与插槽名完全匹配(区分大小写),文件名固定为 `index.vue`。不符合约定的文件不会被加载,这是框架的自动发现机制决定的。
## 第一步:确认工作区(必须阻塞等待用户回复)
本项目是 monorepo 架构,`apps/` 目录下存放各应用。**在执行任何文件读写操作之前**,必须先确认目标应用:
1. 执行 `ls apps/` 列出所有可用应用
2. **立即向用户提问**,明确询问要在哪个应用中创建插槽,并**停止等待回复**
3. 收到用户明确回复后,才能继续后续步骤
> **严格规则**:如果用户没有在请求中明确说明目标应用(例如"在 example 应用中"、"apps/core"),则必须提问,不得自行猜测或默认选择任何应用。
确认后,后续所有文件路径均以该应用目录为根,例如 `apps/<app>/src/slots/`。
## 创建插槽(手动步骤)
1. 创建目录:`apps/<app>/src/slots/{插槽名称}/`
2. 在该目录下创建 `index.vue` 文件,内容参考下方模板
### 普通插槽模板
```vue
<script setup lang="ts">
// 在此添加插槽逻辑
</script>
<template>
<div>
<!-- 在此添加插槽内容 -->
</div>
</template>
<style scoped>
/* 在此添加插槽样式 */
</style>
```
### FreePosition 插槽模板
```vue
<script setup lang="ts">
// 在此添加插槽逻辑
</script>
<template>
<div class="free-position-slot">
<!-- 在此添加插槽内容 -->
<!-- 注意:此插槽需要绝对定位 -->
</div>
</template>
<style scoped>
.free-position-slot {
position: absolute;
/* 在此设置定位坐标,例如: */
/* bottom: 20px; */
/* right: 20px; */
/* z-index: 1000; */
}
</style>
```
## 可用插槽位置
| 区域 | 插槽名称 |
|------|---------|
| 布局 | `LayoutTop`、`LayoutBottom` |
| 头部 | `HeaderStart`、`HeaderAfterLogo`、`HeaderAfterMenu`、`HeaderEnd` |
| 主侧边栏 | `MainSidebarTop`、`MainSidebarAfterLogo`、`MainSidebarAfterMenu`、`MainSidebarBottom` |
| 子侧边栏 | `SubSidebarTop`、`SubSidebarAfterLogo`、`SubSidebarAfterMenu`、`SubSidebarBottom` |
| 标签栏 | `TabbarStart`、`TabbarEnd` |
| 工具栏 | `ToolbarStart`、`ToolbarEnd` |
| 自由定位 | `FreePosition` |
## 选择指南
- 全局顶部横幅/公告(覆盖整个布局最上方) → `LayoutTop`
- 全局底部栏/版权声明(覆盖整个布局最下方) → `LayoutBottom`
- 全局导航元素 → `HeaderStart` / `HeaderEnd`
- 侧边栏用户信息/品牌内容 → `MainSidebarTop` / `MainSidebarAfterLogo`
- 工具栏自定义操作 → `ToolbarStart` / `ToolbarEnd`
- 悬浮元素(需要绝对定位) → `FreePosition`
> `LayoutTop` / `LayoutBottom` 位于整个布局的最外层,内容会横跨全宽,适合全局公告横幅、版权栏等需要独占一行的场景。
## FreePosition 特殊说明
`FreePosition` 插槽需要在样式中手动设置定位,否则内容不可见(模板见上方"FreePosition 插槽模板")。
## 故障排除
插槽未显示?检查:
- 目录名是否与插槽名完全匹配(区分大小写)
- 文件名是否为 `index.vue`
- `apps/<app>/src/slots/` 目录是否存在
@@ -1,258 +0,0 @@
# Fantastic-admin 插槽位置参考
本文档详细介绍 Fantastic-admin 框架中所有可用的插槽位置。
## 插槽分类
### 布局插槽(2 个位置)
位于应用布局的最外层,横跨全宽。
#### LayoutTop
- **位置**:位于整个应用的最顶部,在头部之上
- **适用场景**:
- 全局公告横幅
- 系统维护通知
- Cookie 同意栏
- 试用到期提醒
- **布局方式**:全宽块级容器
- **说明**:内容会将整个布局向下撑开,适合需要立即引起注意的横幅
#### LayoutBottom
- **位置**:位于整个应用的最底部,在页脚之下
- **适用场景**:
- 全局版权声明
- 法律免责声明
- 持久状态栏
- **布局方式**:全宽块级容器
---
### 头部插槽(4 个位置)
位于应用顶部的头部导航栏中。
#### HeaderStart
- **位置**:头部最左侧,logo 之前
- **适用场景**:
- 菜单折叠按钮
- 面包屑导航
- 自定义品牌元素
- **布局方式**:水平弹性布局
#### HeaderAfterLogo
- **位置**:头部 logo 紧后方
- **适用场景**:
- 应用标题或副标题
- 版本徽标
- 环境标识(开发/预发/生产)
- **布局方式**:水平弹性布局
#### HeaderAfterMenu
- **位置**:头部主菜单之后
- **版本要求**:v5.3.0+
- **适用场景**:
- 搜索框
- 快捷操作
- 通知提示
- **布局方式**:水平弹性布局
#### HeaderEnd
- **位置**:头部最右侧
- **适用场景**:
- 用户头像下拉菜单
- 设置按钮
- 退出登录按钮
- 主题切换器
- **布局方式**:水平弹性布局
---
### 主侧边栏插槽(4 个位置)
位于主导航侧边栏中。
#### MainSidebarTop
- **位置**:主侧边栏顶部,logo 之前
- **适用场景**:
- 折叠/展开按钮
- 自定义头部内容
- 工作区选择器
- **布局方式**:垂直弹性布局
#### MainSidebarAfterLogo
- **位置**:主侧边栏 logo 紧后方
- **适用场景**:
- 用户信息卡片
- 快速统计数据
- 工作区名称
- **布局方式**:垂直弹性布局
#### MainSidebarAfterMenu
- **位置**:主侧边栏导航菜单之后
- **版本要求**:v5.3.0+
- **适用场景**:
- 附加导航项
- 快捷方式
- 固定项目
- **布局方式**:垂直弹性布局
#### MainSidebarBottom
- **位置**:主侧边栏底部
- **适用场景**:
- 帮助/支持链接
- 版本信息
- 底部内容
- 折叠按钮
- **布局方式**:垂直弹性布局
---
### 子侧边栏插槽(4 个位置)
位于次级导航侧边栏中(使用多级导航时显示)。
#### SubSidebarTop
- **位置**:子侧边栏顶部
- **适用场景**:
- 区块标题
- 返回按钮
- 面包屑
- **布局方式**:垂直弹性布局
#### SubSidebarAfterLogo
- **位置**:子侧边栏 logo 之后
- **适用场景**:
- 区块描述
- 上下文信息
- **布局方式**:垂直弹性布局
#### SubSidebarAfterMenu
- **位置**:子侧边栏导航菜单之后
- **版本要求**:v5.3.0+
- **适用场景**:
- 附加子导航
- 相关链接
- **布局方式**:垂直弹性布局
#### SubSidebarBottom
- **位置**:子侧边栏底部
- **适用场景**:
- 区块专属操作
- 底部内容
- **布局方式**:垂直弹性布局
---
### 顶部栏插槽(4 个位置)
位于标签栏和工具栏区域。
#### TabbarStart
- **位置**:标签栏左侧
- **适用场景**:
- 标签导航控件
- 刷新按钮
- 自定义标签操作
- **布局方式**:水平弹性布局
#### TabbarEnd
- **位置**:标签栏右侧
- **适用场景**:
- 关闭所有标签按钮
- 标签管理操作
- **布局方式**:水平弹性布局
#### ToolbarStart
- **位置**:工具栏左侧
- **适用场景**:
- 页面专属操作
- 面包屑
- 页面标题
- **布局方式**:水平弹性布局
#### ToolbarEnd
- **位置**:工具栏右侧
- **适用场景**:
- 操作按钮
- 筛选器
- 导出/导入按钮
- **布局方式**:水平弹性布局
---
### 自由定位插槽
#### FreePosition
- **位置**:灵活定位,需手动设置坐标
- **特殊要求**:
- **必须**在样式中使用 `position: absolute;`
- **必须**手动设置定位坐标(top/right/bottom/left)
- **必须**设置合适的 z-index
- **适用场景**:
- 悬浮操作按钮(FAB)
- 客服聊天组件
- 自定义遮罩层
- 通知 Toast
- 帮助按钮
- **样式示例**:
```css
.free-position-slot {
position: absolute;
bottom: 20px;
right: 20px;
z-index: 1000;
}
```
---
## 插槽选择指南
### 何时使用布局插槽:
- 需要显示在所有内容之上的全局横幅(公告、维护通知)
- 需要显示在所有内容之下的全局底栏(版权声明、法律免责)
### 何时使用头部插槽:
- 全局导航元素
- 用户账号控件
- 全局操作按钮
- 品牌元素
### 何时使用侧边栏插槽:
- 导航增强内容
- 用户信息展示
- 工作区上下文
- 帮助与支持链接
### 何时使用顶部栏插槽:
- 页面专属操作
- 标签管理
- 上下文控件
- 面包屑导航
### 何时使用 FreePosition:
- 不适合放入标准布局的悬浮元素
- 需要覆盖在内容之上的元素
- 客服聊天组件或帮助按钮
- 需要自定义定位的组件
---
## 文件结构
所有插槽必须遵循以下目录结构:
```
/src/slots/{插槽名称}/index.vue
```
**注意**:文件名必须为 `index.vue`。
示例:
```
/src/slots/LayoutTop/index.vue
/src/slots/LayoutBottom/index.vue
/src/slots/HeaderStart/index.vue
/src/slots/MainSidebarBottom/index.vue
/src/slots/FreePosition/index.vue
```
@@ -1,77 +0,0 @@
---
name: fa-store-generator
description: 为 Fantastic-admin 框架生成 Pinia Store 模块。当用户提到以下任何需求时必须使用此技能:多个页面需要共享数据、全局状态管理、数据需要持久化(刷新后还在)、登录状态/用户信息需要缓存、购物车/通知/权限等全局数据、需要在组件外访问状态。即使用户只是说"这个数据要全局共享"或"刷新后数据不能丢",也应触发此技能。触发关键词:创建 store、全局状态、状态管理、pinia、持久化、共享数据。
---
# Store Generator
## 第一步:确认工作区(必须阻塞等待用户回复)
本项目是 monorepo 架构,`apps/` 目录下存放各应用。**在执行任何文件读写操作之前**,必须先确认目标应用:
1. 执行 `ls apps/` 列出所有可用应用
2. **立即向用户提问**,明确询问要在哪个应用中创建 Store,并**停止等待回复**
3. 收到用户明确回复后,才能继续后续步骤
> **严格规则**:如果用户没有在请求中明确说明目标应用(例如"在 example 应用中"、"apps/core"),则必须提问,不得自行猜测或默认选择任何应用。
确认后,后续所有文件路径均以该应用目录为根,例如 `apps/<app>/src/store/modules/`。
## 项目 Store 概览
- 位置:`apps/<app>/src/store/modules/` (业务 store)
- 全部使用 **Composition API** 风格(`defineStore` + setup 函数)
- 通过 `unplugin-auto-import` 自动导入,组件中无需手动 import
- 持久化:`pinia-plugin-persistedstate` v4,配置 `persist: { pick: [...] }`
详细模板和示例见 [references/store-patterns.md](references/store-patterns.md)
---
## 交互式工作流
先收集信息再生成代码,因为 store 的字段结构、持久化需求、异步 action 直接决定代码骨架——跳过这步会生成空壳,用户还要大量修改。
### Step 1:收集基本信息
向用户提问(可合并为一次):
1. **Store 用途**:管理什么数据?(例如:用户信息、购物车、通知列表)
2. **存放位置**:
- `apps/<app>/src/store/modules/` — 业务 store(推荐)
- `apps/<app>/src/store/modules/app/` — 框架级 store(仅框架内部使用)
3. **State 字段**:需要哪些状态字段?请列出字段名、类型和初始值
### Step 2:收集功能需求
根据 Step 1 的回答,继续询问:
4. **持久化**:是否需要持久化到 localStorage?如果是,哪些字段需要持久化?
5. **异步 Action**:是否有需要调用 API 的操作?如果有,请描述接口用途
6. **Computed**:是否需要派生状态(computed)?例如:从列表中过滤、统计数量等
### Step 3:确认并生成
汇总用户的回答,展示将要生成的内容摘要,确认后再写入文件。
---
## 命名规范
| 类型 | Store ID | 函数名 | 文件名 |
|------|----------|--------|--------|
| 业务 store | `camelCase` | `use<Name>Store` | `<name>.ts` |
| 框架 store | `app<Name>` | `useApp<Name>Store` | `<name>.ts` |
示例:
- 购物车 → ID: `cart`,函数: `useCartStore`,文件: `apps/<app>/src/store/modules/cart.ts`
- 通知 → ID: `notification`,函数: `useNotificationStore`,文件: `apps/<app>/src/store/modules/notification.ts`
---
## 生成后的操作
Store 文件创建完成后,告知用户:
- 无需手动 import,`unplugin-auto-import` 已自动处理
- 在任意组件/composable 中直接使用:`const xxxStore = useXxxStore()`
- 如需在 store 外部(如路由守卫)使用,需传入 pinia 实例:`useXxxStore(pinia)`
@@ -1,178 +0,0 @@
# Store 模板与示例
## 基础模板
```typescript
import { defineStore } from 'pinia'
export const use<Name>Store = defineStore('<id>', () => {
// State
const <field> = ref<<Type>>(<initialValue>)
// Computed
const <computed> = computed(() => ...)
// Actions
function <action>() {
...
}
return {
<field>,
<computed>,
<action>,
}
})
```
---
## 模板变体
### 1. 纯状态 Store(无持久化、无异步)
```typescript
import { defineStore } from 'pinia'
export const useCartStore = defineStore('cart', () => {
const items = ref<CartItem[]>([])
const visible = ref(false)
const total = computed(() =>
items.value.reduce((sum, item) => sum + item.price * item.quantity, 0),
)
function addItem(item: CartItem) {
const existing = items.value.find(i => i.id === item.id)
if (existing) {
existing.quantity++
}
else {
items.value.push({ ...item, quantity: 1 })
}
}
function removeItem(id: string) {
items.value = items.value.filter(i => i.id !== id)
}
function clear() {
items.value = []
}
return { items, visible, total, addItem, removeItem, clear }
})
```
### 2. 带持久化的 Store
```typescript
import { defineStore } from 'pinia'
export const useUserPreferenceStore = defineStore(
'userPreference',
() => {
const theme = ref<'light' | 'dark'>('light')
const language = ref('zh-cn')
const pageSize = ref(20)
function setTheme(val: 'light' | 'dark') {
theme.value = val
}
return { theme, language, pageSize, setTheme }
},
{
persist: {
pick: ['theme', 'language', 'pageSize'], // 只持久化指定字段
},
},
)
```
> 持久化默认使用 localStorage,key 为 store ID。
> 使用 `pick` 只持久化部分字段,避免持久化临时状态。
### 3. 带异步 Action 的 Store
```typescript
import { defineStore } from 'pinia'
export const useNotificationStore = defineStore('notification', () => {
const list = ref<Notification[]>([])
const loading = ref(false)
const unreadCount = computed(() => list.value.filter(n => !n.read).length)
async function fetchList() {
loading.value = true
try {
const res = await api.notification.list()
list.value = res.data
}
finally {
loading.value = false
}
}
async function markRead(id: string) {
await api.notification.markRead(id)
const item = list.value.find(n => n.id === id)
if (item) {
item.read = true
}
}
return { list, loading, unreadCount, fetchList, markRead }
})
```
### 4. 带 TypeScript 接口定义的 Store
```typescript
import { defineStore } from 'pinia'
interface DictionaryItem {
label: string
value: string | number
}
interface DictionaryState {
[key: string]: DictionaryItem[]
}
export const useDictionaryStore = defineStore('dictionary', () => {
const data = ref<DictionaryState>({})
function getItems(type: string): DictionaryItem[] {
return data.value[type] ?? []
}
async function fetchByType(type: string) {
if (data.value[type]) return // 已缓存,跳过
const res = await api.dictionary.getByType(type)
data.value[type] = res.data
}
return { data, getItems, fetchByType }
})
```
---
## 项目现有 Store 参考
| Store | 文件 | 用途 |
|-------|------|------|
| `useAppAccountStore` | `modules/app/account.ts` | 登录/登出、token、多账号 |
| `useAppSettingsStore` | `modules/app/settings.ts` | 主题、语言、布局配置 |
| `useAppMenuStore` | `modules/app/menu.ts` | 菜单生成与导航状态 |
| `useAppTabbarStore` | `modules/app/tabbar.ts` | 标签栏管理 |
---
## 注意事项
- Store 文件放在 `src/store/modules/` 后,`unplugin-auto-import` 会自动扫描并全局注入,**无需手动 import**
- Store ID 必须全局唯一(camelCase)
- 避免在 store 中直接引用 DOM 或组件实例
- 跨 store 调用:直接在 setup 函数内调用其他 store,如 `const authStore = useAppAccountStore()`
-126
View File
@@ -1,126 +0,0 @@
---
name: fa-theme-customizer
description: 为 Fantastic-admin 框架创建和定制主题配色方案,始终同时生成明色(light)和暗色(dark)两套主题。当用户提到以下任何需求时必须使用此技能:换主题颜色、换配色、做一个 XX 风格的主题、主题太单调了、品牌色是 XXX 帮我生成主题、把 tweakcn 配色转成框架主题、想要暗色/冷色/暖色调、根据设计稿颜色生成主题。即使用户只是描述一种感觉("清新"、"沉稳"、"科技感")或提供一个颜色值("#2563EB"),也应触发此技能。支持"吉卜力"、"赛博朋克"、"莫兰迪"、"北欧极简"等专业设计风格关键词。
---
# 主题定制器
为 Fantastic-admin 框架生成符合规范的主题配色。
## 主题文件位置
- 主题定义:`packages/themes/index.ts`(在此替换新主题,跨所有应用共享)
- 类型推断:自动从 `packages/themes/index.ts` 的 key 推断,无需手动更新类型
## 工作流程
### 第一步:确认设计风格
如果用户没有明确指定颜色,先提供风格参考。读取 `references/design-styles.md` 获取完整的风格目录和配色建议。
### 第二步:生成 OKLCH 色值
框架使用 **OKLCH 色彩空间**,格式为 `L C H`(不含 `oklch()` 包裹,直接写三个数值)。
转换规则:
- 明色背景:`1 0 0`(纯白)或接近白色的暖/冷色调
- 暗色背景:`0.141 0.005 285.823`(默认深灰)或更深的色调
- 主色(primary):明色通常比暗色亮度(L值)高 0.05~0.1
读取 `references/theme-structure.md` 了解完整的 CSS 变量说明和取值规范。
### 第三步:输出主题代码
在 `packages/themes/index.ts` 中替换新主题,格式严格遵循现有主题结构:
```typescript
export const lightTheme = {
// shadcn 标准 token(必填)
'--background': 'L C H',
'--foreground': 'L C H',
'--card': 'L C H',
'--card-foreground': 'L C H',
'--popover': 'L C H',
'--popover-foreground': 'L C H',
'--primary': 'L C H',
'--primary-foreground': 'L C H',
'--secondary': 'L C H',
'--secondary-foreground': 'L C H',
'--muted': 'L C H',
'--muted-foreground': 'L C H',
'--accent': 'L C H',
'--accent-foreground': 'L C H',
'--destructive': '0.577 0.245 27.325', // 通常保持不变
'--border': 'L C H',
'--input': 'L C H',
'--ring': 'L C H', // 通常与 primary 相同
// 框架专属 token(必填)
'--g-main-area-bg': 'oklch(L C H)', // 明色略深于背景,形成层次感
'--g-header-bg': 'oklch(var(--background))',
'--g-header-color': 'oklch(var(--foreground))',
'--g-header-menu-color': 'oklch(var(--accent-foreground))',
'--g-header-menu-hover-bg': 'oklch(var(--accent))',
'--g-header-menu-hover-color': 'oklch(var(--accent-foreground))',
'--g-header-menu-active-bg': 'oklch(var(--primary))',
'--g-header-menu-active-color': 'oklch(var(--primary-foreground))',
'--g-main-sidebar-bg': 'oklch(var(--background))',
'--g-main-sidebar-menu-color': 'oklch(var(--accent-foreground))',
'--g-main-sidebar-menu-hover-bg': 'oklch(var(--accent))',
'--g-main-sidebar-menu-hover-color': 'oklch(var(--accent-foreground))',
'--g-main-sidebar-menu-active-bg': 'oklch(var(--primary))',
'--g-main-sidebar-menu-active-color': 'oklch(var(--primary-foreground))',
'--g-sub-sidebar-bg': 'oklch(var(--background))',
'--g-sub-sidebar-menu-color': 'oklch(var(--accent-foreground))',
'--g-sub-sidebar-menu-hover-bg': 'oklch(var(--accent))',
'--g-sub-sidebar-menu-hover-color': 'oklch(var(--accent-foreground))',
'--g-sub-sidebar-menu-active-bg': 'oklch(var(--primary))',
'--g-sub-sidebar-menu-active-color': 'oklch(var(--primary-foreground))',
'--g-tabbar-bg': 'oklch(var(--background))',
'--g-tabbar-tab-color': 'oklch(var(--accent-foreground) / 50%)',
'--g-tabbar-tab-hover-bg': 'oklch(var(--accent) / 50%)',
'--g-tabbar-tab-hover-color': 'oklch(var(--accent-foreground) / 50%)',
'--g-tabbar-tab-active-bg': 'oklch(var(--accent))',
'--g-tabbar-tab-active-color': 'oklch(var(--foreground))',
'--g-toolbar-bg': 'oklch(var(--background))',
} as const
export const darkTheme = {
// shadcn 标准 token(同明色结构,但色值更深)
'--background': 'L C H',
// ... 其余 shadcn token
// 框架专属 token(暗色与明色有 5 处关键差异,见 references/theme-structure.md)
'--g-main-area-bg': 'oklch(var(--background))', // 暗色与背景相同,避免过多层次
'--g-header-bg': 'oklch(var(--background))',
'--g-header-color': 'oklch(var(--foreground))',
'--g-header-menu-color': 'oklch(var(--muted-foreground))', // 差异:用 muted-foreground
'--g-header-menu-hover-bg': 'oklch(var(--muted))', // 差异:用 muted
'--g-header-menu-hover-color': 'oklch(var(--muted-foreground))',
'--g-header-menu-active-bg': 'oklch(var(--accent))', // 差异:用 accent 而非 primary
'--g-header-menu-active-color': 'oklch(var(--accent-foreground))',
'--g-main-sidebar-bg': 'oklch(var(--background))',
'--g-main-sidebar-menu-color': 'oklch(var(--muted-foreground))',
'--g-main-sidebar-menu-hover-bg': 'oklch(var(--muted))',
'--g-main-sidebar-menu-hover-color': 'oklch(var(--muted-foreground))',
'--g-main-sidebar-menu-active-bg': 'oklch(var(--accent))',
'--g-main-sidebar-menu-active-color': 'oklch(var(--accent-foreground))',
'--g-sub-sidebar-bg': 'oklch(var(--background))',
'--g-sub-sidebar-menu-color': 'oklch(var(--muted-foreground))',
'--g-sub-sidebar-menu-hover-bg': 'oklch(var(--muted))',
'--g-sub-sidebar-menu-hover-color': 'oklch(var(--muted-foreground))',
'--g-sub-sidebar-menu-active-bg': 'oklch(var(--accent))',
'--g-sub-sidebar-menu-active-color': 'oklch(var(--accent-foreground))',
'--g-tabbar-bg': 'oklch(var(--background))',
'--g-tabbar-tab-color': 'oklch(var(--accent-foreground) / 50%)',
'--g-tabbar-tab-hover-bg': 'oklch(var(--accent) / 50%)',
'--g-tabbar-tab-hover-color': 'oklch(var(--accent-foreground) / 50%)',
'--g-tabbar-tab-active-bg': 'oklch(var(--accent))',
'--g-tabbar-tab-active-color': 'oklch(var(--foreground))',
'--g-toolbar-bg': 'oklch(var(--background))',
} as const
```
## 参考资源
- **设计风格目录**:`references/design-styles.md` — 包含 20+ 种专业设计风格的配色方案和灵感来源
- **CSS 变量说明**:`references/theme-structure.md` — 每个变量的作用、取值规范和明暗差异(含完整暗色模板)
- **社区配色**:https://tweakcn.com/community — 可直接参考社区主题的 shadcn CSS 变量
@@ -1,292 +0,0 @@
# 设计风格配色参考目录
收录 20+ 种专业设计风格,每种风格提供核心配色建议(OKLCH 格式)。
## 目录
1. [日系动画风格](#日系动画风格)
2. [科技/未来风格](#科技未来风格)
3. [自然/有机风格](#自然有机风格)
4. [复古/怀旧风格](#复古怀旧风格)
5. [极简主义风格](#极简主义风格)
6. [艺术设计流派](#艺术设计流派)
7. [品牌/商业风格](#品牌商业风格)
8. [tweakcn 社区风格参考](#tweakcn-社区风格参考)
9. [OKLCH 快速参考](#oklch-快速参考)
---
## 日系动画风格
### 吉卜力(Ghibli)
宫崎骏作品的自然温暖色调,大地色系与天空蓝的结合。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.97 0.008 85` | `0.18 0.012 85` | 米白/深棕 |
| primary | `0.62 0.12 145` | `0.55 0.10 145` | 森林绿 |
| secondary | `0.88 0.06 85` | `0.28 0.06 85` | 暖米色 |
| accent | `0.75 0.10 85` | `0.35 0.08 85` | 大地棕 |
| muted | `0.92 0.04 85` | `0.25 0.04 85` | 浅米色 |
灵感:《龙猫》草绿、《千与千寻》暖橙、《哈尔的移动城堡》天蓝
### 新海诚(Makoto Shinkai)
高饱和度的天空蓝与城市光晕,强烈的光影对比。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.97 0.005 240` | `0.12 0.015 240` | 冷白/深夜蓝 |
| primary | `0.58 0.22 240` | `0.52 0.20 240` | 天空蓝 |
| accent | `0.75 0.15 55` | `0.65 0.18 55` | 黄昏橙 |
| muted | `0.92 0.03 240` | `0.22 0.03 240` | 淡蓝灰 |
灵感:《你的名字》黄昏渐变、《天气之子》雨后天空
---
## 科技/未来风格
### 赛博朋克(Cyberpunk)
霓虹粉紫与深黑的强烈对比,高饱和度荧光色。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.95 0.005 300` | `0.08 0.01 300` | 浅紫白/极深黑 |
| primary | `0.65 0.28 330` | `0.72 0.30 330` | 霓虹粉 |
| secondary | `0.60 0.25 280` | `0.55 0.22 280` | 电子紫 |
| accent | `0.75 0.25 195` | `0.70 0.28 195` | 青色荧光 |
| border | `0.85 0.08 300` | `0.25 0.08 300` | 紫色边框 |
灵感:《银翼杀手 2049》、《赛博朋克 2077》
### 终端/黑客(Terminal)
经典绿色终端风格,深黑背景配荧光绿。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.96 0.01 145` | `0.08 0.01 145` | 浅绿白/终端黑 |
| primary | `0.65 0.22 145` | `0.72 0.25 145` | 荧光绿 |
| foreground | `0.15 0.01 145` | `0.90 0.15 145` | 深绿/亮绿 |
| muted | `0.88 0.04 145` | `0.18 0.04 145` | 暗绿 |
### 深空(Deep Space)
NASA 风格的深蓝黑与星云紫,科技感十足。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.96 0.008 250` | `0.10 0.015 250` | 冷白/深空蓝 |
| primary | `0.55 0.20 260` | `0.60 0.22 260` | 星云蓝 |
| accent | `0.65 0.18 300` | `0.60 0.20 300` | 星云紫 |
| secondary | `0.88 0.05 250` | `0.20 0.05 250` | 深蓝灰 |
---
## 自然/有机风格
### 莫兰迪(Morandi)
低饱和度的灰调色彩,优雅克制,源自意大利画家乔治·莫兰迪。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.95 0.008 60` | `0.20 0.008 60` | 灰米白/深灰棕 |
| primary | `0.62 0.06 180` | `0.55 0.05 180` | 灰蓝绿 |
| secondary | `0.85 0.04 60` | `0.30 0.04 60` | 灰米色 |
| accent | `0.72 0.05 30` | `0.40 0.04 30` | 灰玫瑰 |
| muted | `0.90 0.02 60` | `0.25 0.02 60` | 浅灰 |
特点:所有颜色饱和度(C值)控制在 0.02~0.08 之间
### 北欧极简(Scandinavian)
白桦木色调,干净的白色与自然木色,受北欧设计影响。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.98 0.005 80` | `0.16 0.008 80` | 纯白/深木色 |
| primary | `0.45 0.08 80` | `0.55 0.06 80` | 深木棕 |
| secondary | `0.92 0.03 80` | `0.26 0.03 80` | 浅木色 |
| accent | `0.70 0.12 145` | `0.55 0.10 145` | 苔藓绿 |
### 日式侘寂(Wabi-Sabi)
不完美之美,枯山水的灰褐色调,禅意十足。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.94 0.01 70` | `0.18 0.01 70` | 宣纸白/墨色 |
| primary | `0.40 0.05 70` | `0.50 0.04 70` | 枯叶棕 |
| accent | `0.65 0.04 145` | `0.45 0.03 145` | 苔绿 |
| border | `0.82 0.03 70` | `0.28 0.03 70` | 淡墨色 |
---
## 复古/怀旧风格
### 蒸汽朋克(Steampunk)
维多利亚时代的铜色与皮革棕,工业齿轮美学。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.92 0.02 70` | `0.16 0.02 70` | 羊皮纸/深棕 |
| primary | `0.62 0.12 55` | `0.58 0.14 55` | 铜金色 |
| secondary | `0.80 0.06 70` | `0.28 0.06 70` | 皮革棕 |
| accent | `0.55 0.08 200` | `0.50 0.10 200` | 铜绿 |
### 洛可可(Rococo)
18世纪法国宫廷风格,粉彩色调,精致华丽。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.97 0.01 330` | `0.18 0.01 330` | 玫瑰白/深玫瑰 |
| primary | `0.72 0.12 330` | `0.62 0.10 330` | 粉玫瑰 |
| secondary | `0.90 0.05 280` | `0.28 0.05 280` | 淡薰衣草 |
| accent | `0.80 0.08 55` | `0.45 0.08 55` | 香槟金 |
### 复古美式(Retro Americana)
50-70年代美国风格,暖橙与奶油色。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.96 0.02 80` | `0.18 0.02 80` | 奶油色/深棕 |
| primary | `0.68 0.18 45` | `0.62 0.16 45` | 复古橙 |
| secondary | `0.88 0.06 80` | `0.28 0.06 80` | 奶油黄 |
| accent | `0.55 0.12 25` | `0.50 0.10 25` | 砖红 |
---
## 极简主义风格
### 包豪斯(Bauhaus)
功能主义美学,原色(红黄蓝)与黑白灰的几何构成。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `1 0 0` | `0.14 0 0` | 纯白/纯黑 |
| primary | `0.55 0.25 260` | `0.60 0.22 260` | 包豪斯蓝 |
| secondary | `0.90 0 0` | `0.25 0 0` | 浅灰/深灰 |
| accent | `0.65 0.25 25` | `0.60 0.22 25` | 包豪斯红 |
### 瑞士国际主义(Swiss International)
网格系统,Helvetica 精神,黑白红三色。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `1 0 0` | `0.12 0 0` | 纯白/近黑 |
| primary | `0.50 0.25 25` | `0.55 0.22 25` | 瑞士红 |
| foreground | `0.10 0 0` | `0.95 0 0` | 近黑/近白 |
| muted | `0.92 0 0` | `0.22 0 0` | 浅灰/深灰 |
---
## 艺术设计流派
### 孟菲斯(Memphis)
80年代意大利设计运动,高饱和度几何图案,大胆撞色。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.97 0.01 300` | `0.15 0.01 300` | 浅紫白/深紫 |
| primary | `0.70 0.25 330` | `0.65 0.22 330` | 孟菲斯粉 |
| secondary | `0.85 0.08 300` | `0.30 0.08 300` | 薰衣草 |
| accent | `0.75 0.22 85` | `0.70 0.20 85` | 柠檬黄 |
### 新艺术运动(Art Nouveau)
有机曲线,自然植物纹样,金色与绿色。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.96 0.01 80` | `0.16 0.01 80` | 象牙白/深橄榄 |
| primary | `0.55 0.12 145` | `0.50 0.10 145` | 橄榄绿 |
| accent | `0.72 0.15 75` | `0.65 0.12 75` | 金色 |
| secondary | `0.88 0.04 80` | `0.26 0.04 80` | 米色 |
### 波普艺术(Pop Art)
安迪·沃霍尔风格,高对比度,鲜艳原色。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `1 0 0` | `0.10 0 0` | 纯白/纯黑 |
| primary | `0.72 0.28 25` | `0.68 0.25 25` | 波普红 |
| secondary | `0.88 0.20 85` | `0.35 0.15 85` | 波普黄 |
| accent | `0.60 0.25 240` | `0.55 0.22 240` | 波普蓝 |
---
## 品牌/商业风格
### 科技蓝(Tech Blue)
企业级科技感,参考 IBM、Microsoft 风格。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.98 0.003 240` | `0.13 0.005 240` | 冷白/深蓝黑 |
| primary | `0.55 0.20 250` | `0.60 0.18 250` | 科技蓝 |
| secondary | `0.92 0.02 240` | `0.22 0.02 240` | 浅蓝灰 |
| accent | `0.65 0.15 200` | `0.58 0.12 200` | 青蓝 |
### 金融绿(Finance Green)
稳健专业,参考彭博、路透风格。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.97 0.005 145` | `0.12 0.008 145` | 冷白/深绿黑 |
| primary | `0.52 0.18 145` | `0.58 0.16 145` | 金融绿 |
| secondary | `0.90 0.03 145` | `0.22 0.03 145` | 浅绿灰 |
| accent | `0.65 0.12 85` | `0.60 0.10 85` | 金色点缀 |
### 奢华黑金(Luxury)
高端品牌风格,深黑配金色,参考 Chanel、Rolex。
| 变量 | 明色 L C H | 暗色 L C H | 说明 |
|------|-----------|-----------|------|
| background | `0.96 0.005 75` | `0.10 0.005 75` | 象牙白/近黑 |
| primary | `0.68 0.12 75` | `0.72 0.14 75` | 金色 |
| foreground | `0.12 0.005 75` | `0.92 0.005 75` | 近黑/近白 |
| border | `0.80 0.06 75` | `0.25 0.06 75` | 金色边框 |
---
## tweakcn 社区风格参考
tweakcn(https://tweakcn.com/community)是 shadcn/ui 的主题社区,提供大量社区贡献的配色方案。
### 如何使用社区主题
1. 访问 https://tweakcn.com/community 浏览社区主题
2. 找到喜欢的主题,点击查看其 CSS 变量
3. 社区主题使用标准 shadcn CSS 变量格式,可直接转换
### 转换说明
社区主题的 CSS 变量格式通常为:
```css
:root {
--background: oklch(1 0 0);
--primary: oklch(0.623 0.214 259.815);
}
```
转换到框架格式时,去掉 `oklch()` 包裹,只保留三个数值,再补充框架专属的 `--g-*` 变量。
### 知名社区主题风格
- **Catppuccin** — 柔和粉彩,有 Latte/Frappé/Macchiato/Mocha 四个变体
- **Dracula** — 经典暗色,紫色系
- **Nord** — 北极极光,冷蓝色系
- **Solarized** — 护眼配色,暖黄底色
- **Gruvbox** — 复古暖色,棕黄系
- **Tokyo Night** — 深蓝紫夜晚城市风格
- **One Dark** — Atom 编辑器经典暗色主题
- **Everforest** — 森林绿色系,护眼舒适
---
## OKLCH 快速参考
### 亮度(L)
- `1.0` 纯白 / `0.97~0.99` 明色背景 / `0.50~0.70` 主色常用范围 / `0.10~0.18` 暗色背景 / `0.0` 纯黑
### 饱和度(C)
- `0` 无彩色 / `0.01~0.05` 极低(莫兰迪)/ `0.15~0.22` 中等(大多数主题)/ `0.25+` 高饱和(赛博朋克)
### 色相(H)
- `0~30` 红 / `30~60` 橙棕 / `60~90` 黄 / `90~150` 绿 / `150~210` 青 / `210~270` 蓝 / `270~330` 紫 / `330~360` 粉玫瑰
@@ -1,169 +0,0 @@
# 主题 CSS 变量结构说明
## 变量分类
主题由两类变量组成:
1. **shadcn 标准 token** — 通用设计系统变量,控制组件颜色
2. **框架专属 token(`--g-*`)** — 控制布局区域颜色
---
## shadcn 标准 Token
格式:`'L C H'`(OKLCH 三个数值,不含 `oklch()` 包裹)
| 变量 | 作用 |
|------|------|
| `--background` | 页面主背景色 |
| `--foreground` | 主文字颜色 |
| `--card` | 卡片背景色(通常同 background) |
| `--card-foreground` | 卡片文字颜色 |
| `--popover` | 弹出层背景色 |
| `--popover-foreground` | 弹出层文字颜色 |
| `--primary` | 主色调(按钮、高亮、激活状态) |
| `--primary-foreground` | 主色上的文字颜色 |
| `--secondary` | 次要色(次要按钮、标签背景) |
| `--secondary-foreground` | 次要色上的文字颜色 |
| `--muted` | 静音色(禁用状态、次要背景) |
| `--muted-foreground` | 静音色上的文字颜色 |
| `--accent` | 强调色(hover 状态背景) |
| `--accent-foreground` | 强调色上的文字颜色 |
| `--destructive` | 危险/错误色(删除、警告) |
| `--border` | 边框颜色 |
| `--input` | 输入框边框颜色 |
| `--ring` | 焦点环颜色(通常同 primary) |
---
## 框架专属 Token(`--g-*`)
格式:`'oklch(L C H)'` 或 `'oklch(var(--xxx))'`(含 `oklch()` 包裹)
| 变量 | 作用 |
|------|------|
| `--g-main-area-bg` | 主内容区域背景 |
| `--g-header-bg` | 顶部背景 |
| `--g-header-color` | 顶部文字颜色 |
| `--g-header-menu-color` | 顶部导航菜单项文字颜色 |
| `--g-header-menu-hover-bg` | 顶部导航菜单项 hover 背景 |
| `--g-header-menu-hover-color` | 顶部导航菜单项 hover 文字颜色 |
| `--g-header-menu-active-bg` | 顶部导航菜单项激活背景 |
| `--g-header-menu-active-color` | 顶部导航菜单项激活文字颜色 |
| `--g-main-sidebar-bg` | 主侧边栏背景 |
| `--g-main-sidebar-menu-color` | 主侧边栏导航菜单文字颜色 |
| `--g-main-sidebar-menu-hover-bg` | 主侧边栏导航菜单 hover 背景 |
| `--g-main-sidebar-menu-hover-color` | 主侧边栏导航菜单 hover 文字颜色 |
| `--g-main-sidebar-menu-active-bg` | 主侧边栏导航菜单激活背景 |
| `--g-main-sidebar-menu-active-color` | 主侧边栏导航菜单激活文字颜色 |
| `--g-sub-sidebar-bg` | 次侧边栏背景 |
| `--g-sub-sidebar-menu-color` | 次侧边栏导航菜单文字颜色 |
| `--g-sub-sidebar-menu-hover-bg` | 次侧边栏导航菜单 hover 背景 |
| `--g-sub-sidebar-menu-hover-color` | 次侧边栏导航菜单 hover 文字颜色 |
| `--g-sub-sidebar-menu-active-bg` | 次侧边栏导航菜单激活背景 |
| `--g-sub-sidebar-menu-active-color` | 次侧边栏导航菜单激活文字颜色 |
| `--g-tabbar-bg` | 标签栏背景 |
| `--g-tabbar-tab-color` | 标签项文字颜色 |
| `--g-tabbar-tab-hover-bg` | 标签项 hover 背景 |
| `--g-tabbar-tab-hover-color` | 标签项 hover 文字颜色 |
| `--g-tabbar-tab-active-bg` | 标签项激活背景 |
| `--g-tabbar-tab-active-color` | 标签项激活文字颜色 |
| `--g-toolbar-bg` | 工具栏背景 |
---
## 明色与暗色的关键差异
### 差异一:菜单激活状态
明色使用 `primary`,暗色使用 `accent`:
```typescript
// 明色
'--g-header-menu-active-bg': 'oklch(var(--primary))',
'--g-header-menu-active-color': 'oklch(var(--primary-foreground))',
// 暗色
'--g-header-menu-active-bg': 'oklch(var(--accent))',
'--g-header-menu-active-color': 'oklch(var(--accent-foreground))',
```
同样适用于 `--g-main-sidebar-menu-active-*` 和 `--g-sub-sidebar-menu-active-*`。
### 差异二:主内容区背景
```typescript
// 明色:略深于背景,形成层次感
'--g-main-area-bg': 'oklch(0.9612 0 0)',
// 暗色:与背景相同,避免过多层次
'--g-main-area-bg': 'oklch(var(--background))',
```
### 差异三:标签栏 hover 背景
```typescript
// 明色
'--g-tabbar-tab-hover-bg': 'oklch(var(--border))',
// 暗色
'--g-tabbar-tab-hover-bg': 'oklch(var(--accent) / 50%)',
```
### 差异四:标签栏激活背景
```typescript
// 明色
'--g-tabbar-tab-active-bg': 'oklch(var(--background))',
// 暗色
'--g-tabbar-tab-active-bg': 'oklch(var(--secondary))',
```
### 差异五:菜单颜色引用
```typescript
// 明色:使用 accent-foreground
'--g-header-menu-color': 'oklch(var(--accent-foreground))',
'--g-header-menu-hover-color': 'oklch(var(--accent-foreground))',
// 暗色:使用 muted-foreground
'--g-header-menu-color': 'oklch(var(--muted-foreground))',
'--g-header-menu-hover-color': 'oklch(var(--muted-foreground))',
```
---
## 完整暗色 `--g-*` 模板
```typescript
dark: {
// shadcn token ...
'--g-main-area-bg': 'oklch(var(--background))',
'--g-header-bg': 'oklch(var(--background))',
'--g-header-color': 'oklch(var(--foreground))',
'--g-header-menu-color': 'oklch(var(--muted-foreground))',
'--g-header-menu-hover-bg': 'oklch(var(--muted))',
'--g-header-menu-hover-color': 'oklch(var(--muted-foreground))',
'--g-header-menu-active-bg': 'oklch(var(--accent))',
'--g-header-menu-active-color': 'oklch(var(--accent-foreground))',
'--g-main-sidebar-bg': 'oklch(var(--background))',
'--g-main-sidebar-menu-color': 'oklch(var(--muted-foreground))',
'--g-main-sidebar-menu-hover-bg': 'oklch(var(--muted))',
'--g-main-sidebar-menu-hover-color': 'oklch(var(--muted-foreground))',
'--g-main-sidebar-menu-active-bg': 'oklch(var(--accent))',
'--g-main-sidebar-menu-active-color': 'oklch(var(--accent-foreground))',
'--g-sub-sidebar-bg': 'oklch(var(--background))',
'--g-sub-sidebar-menu-color': 'oklch(var(--muted-foreground))',
'--g-sub-sidebar-menu-hover-bg': 'oklch(var(--muted))',
'--g-sub-sidebar-menu-hover-color': 'oklch(var(--muted-foreground))',
'--g-sub-sidebar-menu-active-bg': 'oklch(var(--accent))',
'--g-sub-sidebar-menu-active-color': 'oklch(var(--accent-foreground))',
'--g-tabbar-bg': 'oklch(var(--background))',
'--g-tabbar-tab-color': 'oklch(var(--accent-foreground) / 50%)',
'--g-tabbar-tab-hover-bg': 'oklch(var(--accent) / 50%)',
'--g-tabbar-tab-hover-color': 'oklch(var(--accent-foreground) / 50%)',
'--g-tabbar-tab-active-bg': 'oklch(var(--accent))',
'--g-tabbar-tab-active-color': 'oklch(var(--foreground))',
'--g-toolbar-bg': 'oklch(var(--background))',
},
```
-1
View File
@@ -1 +0,0 @@
../../.agents/skills/fa-crud-page-generator
-1
View File
@@ -1 +0,0 @@
../../.agents/skills/fa-feedback
-1
View File
@@ -1 +0,0 @@
../../.agents/skills/fa-form-builder
-1
View File
@@ -1 +0,0 @@
../../.agents/skills/fa-framework-settings
-1
View File
@@ -1 +0,0 @@
../../.agents/skills/fa-page-optimizer
-1
View File
@@ -1 +0,0 @@
../../.agents/skills/fa-route-generator
-1
View File
@@ -1 +0,0 @@
../../.agents/skills/fa-slot-creator
-1
View File
@@ -1 +0,0 @@
../../.agents/skills/fa-store-generator
-1
View File
@@ -1 +0,0 @@
../../.agents/skills/fa-theme-customizer
-68
View File
@@ -1,68 +0,0 @@
/** @type {import('cz-git').UserConfig} */
export default {
rules: {
// @see: https://commitlint.js.org/#/reference-rules
},
prompt: {
alias: { fd: 'docs: fix typos' },
messages: {
type: '选择你要提交的类型 :',
scope: '选择一个提交范围(可选):',
customScope: '请输入自定义的提交范围 :',
subject: '填写简短精炼的变更描述 :\n',
body: '填写更加详细的变更描述(可选)。使用 "|" 换行 :\n',
breaking: '列举非兼容性重大的变更(可选)。使用 "|" 换行 :\n',
footerPrefixsSelect: '选择关联issue前缀(可选):',
customFooterPrefixs: '输入自定义issue前缀 :',
footer: '列举关联issue (可选) 例如: #31, #I3244 :\n',
confirmCommit: '是否提交或修改commit ?',
},
types: [
{ value: 'feat', name: 'feat: ✨ 新增功能 | A new feature', emoji: ':sparkles:' },
{ value: 'fix', name: 'fix: 🐛 修复缺陷 | A bug fix', emoji: ':bug:' },
{ value: 'docs', name: 'docs: 📝 文档更新 | Documentation only changes', emoji: ':memo:' },
{ value: 'style', name: 'style: 💄 代码格式 | Changes that do not affect the meaning of the code', emoji: ':lipstick:' },
{ value: 'refactor', name: 'refactor: ♻️ 代码重构 | A code change that neither fixes a bug nor adds a feature', emoji: ':recycle:' },
{ value: 'perf', name: 'perf: ⚡️ 性能提升 | A code change that improves performance', emoji: ':zap:' },
{ value: 'test', name: 'test: ✅ 测试相关 | Adding missing tests or correcting existing tests', emoji: ':white_check_mark:' },
{ value: 'build', name: 'build: 📦️ 构建相关 | Changes that affect the build system or external dependencies', emoji: ':package:' },
{ value: 'ci', name: 'ci: 🎡 持续集成 | Changes to our CI configuration files and scripts', emoji: ':ferris_wheel:' },
{ value: 'revert', name: 'revert: ⏪️ 回退代码 | Revert to a commit', emoji: ':rewind:' },
{ value: 'chore', name: 'chore: 🔨 其他修改 | Other changes that do not modify src or test files', emoji: ':hammer:' },
],
useEmoji: false,
emojiAlign: 'center',
themeColorCode: '',
scopes: [],
allowCustomScopes: true,
allowEmptyScopes: true,
customScopesAlign: 'bottom',
customScopesAlias: 'custom',
emptyScopesAlias: 'empty',
upperCaseSubject: false,
markBreakingChangeMode: true,
allowBreakingChanges: ['feat', 'fix'],
breaklineNumber: 100,
breaklineChar: '|',
skipQuestions: [],
issuePrefixs: [
// 如果使用 gitee 作为开发管理
{ value: 'link', name: 'link: 链接 ISSUES 进行中' },
{ value: 'closed', name: 'closed: 标记 ISSUES 已完成' },
],
customIssuePrefixsAlign: 'top',
emptyIssuePrefixsAlias: 'skip',
customIssuePrefixsAlias: 'custom',
allowCustomIssuePrefixs: true,
allowEmptyIssuePrefixs: true,
confirmColorize: true,
maxHeaderLength: Number.POSITIVE_INFINITY,
maxSubjectLength: Number.POSITIVE_INFINITY,
minSubjectLength: 0,
scopeOverrides: undefined,
defaultBody: '',
defaultIssues: '',
defaultScope: '',
defaultSubject: '',
},
}
+10
View File
@@ -0,0 +1,10 @@
{
"recommendations": [
"EditorConfig.EditorConfig",
"mikestead.dotenv",
"dbaeumer.vscode-eslint",
"stylelint.vscode-stylelint",
"Vue.volar",
"antfu.unocss"
]
}
+29
View File
@@ -0,0 +1,29 @@
{
"eslint.useFlatConfig": true,
"prettier.enable": false,
"editor.formatOnSave": false,
"editor.codeActionsOnSave": {
"source.fixAll.eslint": "explicit",
"source.fixAll.stylelint": "explicit",
"source.organizeImports": "never"
},
"stylelint.validate": [
"css",
"postcss",
"scss",
"vue"
],
"eslint.validate": [
"javascript",
"javascriptreact",
"typescript",
"typescriptreact",
"vue",
"html",
"markdown",
"json",
"jsonc",
"yaml"
],
"typescript.tsdk": "node_modules/typescript/lib"
}
+15
View File
@@ -0,0 +1,15 @@
# 应用配置面板
VITE_APP_SETTING = true
# 页面标题
VITE_APP_TITLE = Fantastic-admin 基础版
# 接口请求地址,会设置到 axios 的 baseURL 参数上
VITE_APP_API_BASEURL = /
# 调试工具,可设置 eruda 或 vconsole,如果不需要开启则留空
VITE_APP_DEBUG_TOOL =
# 是否禁用开发者工具,可防止被调试
VITE_APP_DISABLE_DEVTOOL = false
# 是否开启代理
VITE_OPEN_PROXY = false
# 是否开启开发者工具
VITE_OPEN_DEVTOOLS = true
Executable
+19
View File
@@ -0,0 +1,19 @@
# 应用配置面板
VITE_APP_SETTING = true
# 页面标题
VITE_APP_TITLE = Fantastic-admin 基础版
# 接口请求地址,会设置到 axios 的 baseURL 参数上
VITE_APP_API_BASEURL = /
# 调试工具,可设置 eruda 或 vconsole,如果不需要开启则留空
VITE_APP_DEBUG_TOOL =
# 是否禁用开发者工具,可防止被调试
VITE_APP_DISABLE_DEVTOOL = true
# 是否在打包时启用 Mock
VITE_BUILD_MOCK = true
# 是否在打包时生成 sourcemap
VITE_BUILD_SOURCEMAP = false
# 是否在打包时开启压缩,支持 gzip 和 brotli
VITE_BUILD_COMPRESS = gzip,brotli
# 是否在打包后生成存档,支持 zip 和 tar
VITE_BUILD_ARCHIVE =
-59
View File
@@ -1,59 +0,0 @@
name: Deploy Example
on:
push:
branches: [main]
paths:
- 'apps/example/**'
- pnpm-lock.yaml
- pnpm-workspace.yaml
workflow_dispatch:
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
with:
fetch-depth: 0
- name: Setup Node.js
uses: actions/setup-node@v6
with:
node-version: 22
- uses: pnpm/action-setup@v4
name: Install pnpm
with:
run_install: false
- name: Get pnpm store directory
shell: bash
run: |
echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
- uses: actions/cache@v5
name: Setup pnpm cache
with:
path: ${{ env.STORE_PATH }}
key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
restore-keys: |
${{ runner.os }}-pnpm-store-
- name: Install dependencies
run: pnpm install --frozen-lockfile
- name: Build site
run: pnpm --filter example build
- name: deploy
uses: peaceiris/actions-gh-pages@v4
with:
deploy_key: ${{ secrets.DEPLOY_EXAMPLE }}
external_repository: fantastic-admin/basic-example
publish_branch: main
publish_dir: ./apps/example/dist
enable_jekyll: true
force_orphan: true
user_name: 'github-actions[bot]'
user_email: 'github-actions[bot]@users.noreply.github.com'
-54
View File
@@ -1,54 +0,0 @@
name: Release
on:
push:
tags:
- 'v*'
jobs:
release:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
with:
fetch-depth: 0
- uses: actions/setup-node@v6
with:
node-version: 22
- run: npx changelogithub # or changelogithub@0.12 if ensure the stable result
env:
GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
upload-archive:
needs: release
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
with:
fetch-depth: 0
- name: Get Release
id: last_release
uses: joutvhu/get-release@v1
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
latest: true
- name: Create Archive
uses: thedoctor0/zip-release@main
with:
type: zip
filename: fantastic-admin.${{ steps.last_release.outputs.tag_name }}.zip
exclusions: '/.git/* /.github/* /.agents/* /.claude/* /CLAUDE.md'
- name: Upload Archive To Release
uses: xresloader/upload-to-github-release@v1
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
release_id: ${{ steps.last_release.outputs.id }}
draft: false
file: fantastic-admin.${{ steps.last_release.outputs.tag_name }}.zip
-36
View File
@@ -1,36 +0,0 @@
name: repo-sync
on:
# 每天 00:05 自动同步
schedule:
- cron: '5 0 * * *'
# 手动触发部署
workflow_dispatch:
jobs:
sync-to-gitee:
runs-on: ubuntu-latest
steps:
- name: Sync to Gitee
uses: wearerequired/git-mirror-action@master
env:
# 注意在 Settings->Secrets 配置 GITEE_RSA_PRIVATE_KEY
SSH_PRIVATE_KEY: ${{ secrets.GITEE_RSA_PRIVATE_KEY }}
with:
# 注意替换为你的 GitHub 源仓库地址
source-repo: git@github.com:fantastic-admin/basic.git
# 注意替换为你的 Gitee 目标仓库地址
destination-repo: git@gitee.com:fantastic-admin/basic.git
sync-to-atomgit:
runs-on: ubuntu-latest
steps:
- name: Sync to AtomGit
uses: wearerequired/git-mirror-action@master
env:
# 注意在 Settings->Secrets 配置 ATOMGIT_RSA_PRIVATE_KEY
SSH_PRIVATE_KEY: ${{ secrets.ATOMGIT_RSA_PRIVATE_KEY }}
with:
# 注意替换为你的 GitHub 源仓库地址
source-repo: git@github.com:fantastic-admin/basic.git
# 注意替换为你的 AtomGit 目标仓库地址
destination-repo: git@gitcode.com:fantastic-admin/basic.git
Executable → Regular
+1 -1
View File
@@ -1 +1 @@
24
22
Executable
+4
View File
@@ -0,0 +1,4 @@
shamefully-hoist=true
strict-peer-dependencies=false
engine-strict=true
verify-deps-before-run=prompt
-3
View File
@@ -1,9 +1,6 @@
{
"npm.packageManager": "pnpm",
"js/ts.tsdk.path": "node_modules/typescript/lib",
"search.exclude": {
"**/dist*": true
},
"prettier.enable": false,
"editor.formatOnSave": false,
"editor.codeActionsOnSave": {
-72
View File
@@ -1,72 +0,0 @@
# Fantastic-admin
## 项目概述
Fantastic-admin 是一个基于 Vue 3 的后台管理框架。
## 技术栈
- **框架**: Vue 3.6 + TypeScript + Vite 8
- **UI 组件**: Element Plus(默认,可替换) + Reka UI + UnoCSS(原子化 CSS)
- **状态管理**: Pinia + pinia-plugin-persistedstate
- **路由**: Vue Router 5
- **包管理器**: pnpm(必须使用 pnpm,禁止使用 npm/yarn)
- **HTTP**: Axios
- **Mock**: vite-plugin-fake-server
## 目录结构
采用 pnpm monorepo 架构:
```
├── apps/
│ └── <app>/ # 应用
│ └── src/
│ ├── api/ # API 请求模块
│ ├── assets/ # 静态资源
│ ├── components/ # 全局业务组件
│ ├── composables/ # 组合式函数
│ ├── layouts/ # 布局组件
│ ├── router/ # 路由配置
│ ├── slots/ # 插槽组件
│ ├── store/ # Pinia store
│ ├── types/ # TypeScript 类型定义
│ ├── ui/ # 框架内建 UI 组件(本地)
│ ├── utils/ # 工具函数
│ └── views/ # 页面视图
├── packages/
│ ├── components/ # 框架内建 UI 组件库(子包,跨应用共享)
│ ├── settings/ # 框架设置(子包,跨应用共享)
│ └── themes/ # 主题配置(子包,跨应用共享)
├── scripts/ # 工程脚本
└── pnpm-workspace.yaml # monorepo workspace 配置
```
## 常用命令
```bash
pnpm dev # 启动开发服务器
pnpm build # 构建
pnpm lint # 运行全量 lint(tsc + eslint + stylelint)
```
## 开发规范
- 使用 `<script setup lang="ts">` 语法
- 样式优先使用 UnoCSS 原子类,复杂样式用 SCSS
- 组件命名使用 PascalCase,文件名与组件名一致
- API 模块放在 `apps/<app>/src/api/modules/`,按业务模块拆分
- Store 模块放在 `apps/<app>/src/store/modules/`,使用 Pinia composition API 风格
- 路由配置在 `apps/<app>/src/router/`,meta 属性可借助 fa-route-generator skill
## 注意事项
- 框架内建组件在 `packages/components/` 子包中,优先使用内建组件而非第三方组件或自定义实现
- 在任何情况下都请勿直接修改内建组件,确定修改前需要和用户进行确认
- Mock 数据使用 `vite-plugin-fake-server`,文件放在 `apps/<app>/src/api/modules/` 对应模块旁
- 代码提交前会自动运行 lint-staged,确保代码符合规范
- Node.js 版本要求以根目录下 `package.json` 中定义的为准
## 反复修改检测
在使用任何 fa-* 系列技能时,如果用户针对同一功能点已经要求修改 3 次及以上仍未达到预期(例如连续说"不对"、"再改改"、"还是不行"),必须触发 fa-feedback 技能,询问用户是否将问题反馈给框架作者。
-1
View File
@@ -1 +0,0 @@
AGENTS.md
-55
View File
@@ -1,55 +0,0 @@
[中文](./readme.md) | **English**
<a href="https://fantastic-admin.hurui.me" target="_blank"><img src="https://fantastic-admin.hurui.me/logo.svg" align="right" height="80" alt="logo" /></a>
# Fantastic-admin
An **AI-oriented** admin system framework
<p>
<a href="https://fantastic-admin.hurui.me" target="_blank">Official Website</a>
<span>&nbsp;|&nbsp;</span>
<a href="https://fantastic-admin.pages.dev" target="_blank">Backup URL</a>
</p>
<p>
<a href="###"><img src="https://img.shields.io/github/license/fantastic-admin/basic?label=License&style=flat-square" alt="" /></a>
<a href="https://github.com/fantastic-admin/basic/releases" target="_blank"><img src="https://img.shields.io/github/v/release/fantastic-admin/basic?label=Current%20Version&style=flat-square" alt="" /></a>
</p>
![hero](https://fantastic-admin.hurui.me/hero_preview.png)
## Features
> Some features are available in the Professional Edition
- AI-friendly engineering foundation with multiple built-in Skills
- First-class tech stack: Vue 3.6 / Vite 8 / Pinia / UnoCSS / VueUse / TypeScript / ESLint / Stylelint / ...
- Freely choose your preferred UI library
- 8 built-in theme schemes with extensibility for distinct industry brand styles
- 7 navigation menu modes to match products at different growth stages
- Fine-grained and controllable page keep-alive strategy
- Comprehensive permission validation
- Internationalization and RTL support
- 19 reserved slots for flexible product extensions
## Download
> This repository is the Basic Edition
Pulling the source code directly may include unreleased content. It is recommended to download the stable release package from the [Github Releases](https://github.com/fantastic-admin/basic/releases) page.
## Support
If you find Fantastic-admin useful, or you are already using it, please consider giving it a star on **Github** / **Gitee** / **GitCode**. This is a significant help for the project's visibility.
[![star](https://img.shields.io/github/stars/fantastic-admin/basic?style=social)](https://github.com/fantastic-admin/basic)
[![star](https://gitee.com/fantastic-admin/basic/badge/star.svg?theme=dark)](https://gitee.com/fantastic-admin/basic)
[![star](https://atomgit.com/fantastic-admin/basic/star/badge.svg)](https://atomgit.com/fantastic-admin/basic)
## Ecosystem
- [`Fantastic-startkit`](https://hooray.github.io/fantastic-startkit/) - A simple and easy-to-use Vue 3 project starter kit
- [`Fantastic-mobile`](https://fantastic-mobile.hurui.me/) - Let your H5 project have a solid engineering base
- [`One-step-admin`](https://one-step-admin.hurui.me) - A Vue admin framework built to help you move faster than the rest
-55
View File
@@ -1,55 +0,0 @@
**中文** | [English](./README.EN.md)
<a href="https://fantastic-admin.hurui.me" target="_blank"><img src="https://fantastic-admin.hurui.me/logo.svg" align="right" height="80" alt="logo" /></a>
# Fantastic-admin
面向 **AI** 的管理系统框架
<p>
<a href="https://fantastic-admin.hurui.me" target="_blank">官网</a>
<span>&nbsp;|&nbsp;</span>
<a href="https://fantastic-admin.pages.dev" target="_blank">备用地址</a>
</p>
<p>
<a href="###"><img src="https://img.shields.io/github/license/fantastic-admin/basic?label=%E5%BC%80%E6%BA%90%E5%8D%8F%E8%AE%AE&style=flat-square" alt="" /></a>
<a href="https://github.com/fantastic-admin/basic/releases" target="_blank"><img src="https://img.shields.io/github/v/release/fantastic-admin/basic?label=%E5%BD%93%E5%89%8D%E7%89%88%E6%9C%AC&style=flat-square" alt="" /></a>
</p>
![hero](https://fantastic-admin.hurui.me/hero_preview.png)
## 特点
> 部分为专业版能力
- AI 友好的工程底座,内置多个 Skills
- 一流的技术栈:Vue 3.6 / Vite 8 / Pinia / UnoCSS / VueUse / TypeScript / ESLint / Stylelint / ...
- 自由选择喜爱的三方 UI 库
- 18 套默认主题方案且可扩展,给不同行业提供专属品牌气质
- 7 款导航菜单模式,匹配产品发展的各个阶段
- 精细可控的页面保活策略
- 全方位权限验证
- 国际化、RTL支持
- 19 处预留插槽,灵活扩展产品内容
## 下载
> 本仓库为基础版
直接拉取源码可能会包含未发布的内容,推荐去 [Github Releases](https://github.com/fantastic-admin/basic/releases) 页面下载稳定版本的压缩包。
## 支持
如果觉得 Fantastic-admin 这个框架不错,或者已经在使用了,希望你可以在 **Github** / **Gitee** / **GitCode** 帮我点个 ⭐ ,这将对本产品的推广有极大帮助。
[![star](https://img.shields.io/github/stars/fantastic-admin/basic?style=social)](https://github.com/fantastic-admin/basic)
[![star](https://gitee.com/fantastic-admin/basic/badge/star.svg?theme=dark)](https://gitee.com/fantastic-admin/basic)
[![star](https://atomgit.com/fantastic-admin/basic/star/badge.svg)](https://atomgit.com/fantastic-admin/basic)
## 生态
- [`Fantastic-startkit`](https://hooray.github.io/fantastic-startkit/) - 简单好用的 Vue3 项目启动套件
- [`Fantastic-mobile`](https://fantastic-mobile.hurui.me/) - 让你的 H5 项目拥有稳固的工程底座
- [`One-step Console`](https://one-step-admin.hurui.me) - 像导播一样编排你的工作现场
-40
View File
@@ -1,40 +0,0 @@
# 应用配置面板
# Application configuration panel
VITE_APP_SETTING = true
# 网站标题
# Website title
VITE_APP_TITLE = Fantastic-admin
# 网络请求地址,应用于 axios 的 baseURL
# Network request address, applied to axios's baseURL
VITE_APP_API_BASEURL = /
# localStorage/sessionStorage 前缀
# localStorage/sessionStorage prefix
VITE_APP_STORAGE_PREFIX = fa_dev_
# 调试工具,可设置 eruda 或 vconsole
# Debugging tool, can set eruda or vconsole
VITE_APP_DEBUG_TOOL =
# ===== 以下配置仅在开发环境生效 =====
# ===== The following configuration is only effective in the development environment. =====
# 启用代理
# Enable proxy
VITE_ENABLE_PROXY = false
# 启用 Vue 开发工具
# Enable Vue DevTools
VITE_ENABLE_VUE_DEVTOOLS = false
# 启用 turbo console
# Enable turbo console
VITE_ENABLE_TURBO_CONSOLE = false
# 启动编辑器,用于 vite-plugin-vue-devtools 和 unplugin-turbo-console
# 支持的编辑器 https://github.com/yyx990803/launch-editor#supported-editors
# Launch the editor for vite-plugin-vue-devtools and unplugin-turbo-console
# Supported editors https://github.com/yyx990803/launch-editor#supported-editors
VITE_LAUNCH_EDITOR = code
-38
View File
@@ -1,38 +0,0 @@
# 应用配置面板
# Application configuration panel
VITE_APP_SETTING = false
# 网站标题
# Website title
VITE_APP_TITLE = Fantastic-admin
# 网络请求地址,应用于 axios 的 baseURL
# Network request address, applied to axios's baseURL
VITE_APP_API_BASEURL = /
# localStorage/sessionStorage 前缀
# localStorage/sessionStorage prefix
VITE_APP_STORAGE_PREFIX = fa_
# 调试工具,可设置 eruda 或 vconsole
# Debugging tool, can set eruda or vconsole
VITE_APP_DEBUG_TOOL =
# ===== 以下配置仅在生产环境生效 =====
# ===== The following configuration is only effective in the production environment. =====
# 启用假数据
# Enable build fake data
VITE_BUILD_FAKE = false
# 启用 sourcemap
# Enable build sourcemap
VITE_BUILD_SOURCEMAP = false
# 压缩方式,支持 gzip 和 brotli
# Build compression method, supports gzip and brotli
VITE_BUILD_COMPRESS = gzip,brotli
# 构建后生成存档,支持 zip 和 tar
# Generate archive after build, supports zip and tar
VITE_BUILD_ARCHIVE =
-38
View File
@@ -1,38 +0,0 @@
# 应用配置面板
# Application configuration panel
VITE_APP_SETTING = false
# 网站标题
# Website title
VITE_APP_TITLE = Fantastic-admin
# 网络请求地址,应用于 axios 的 baseURL
# Network request address, applied to axios's baseURL
VITE_APP_API_BASEURL = /
# localStorage/sessionStorage 前缀
# localStorage/sessionStorage prefix
VITE_APP_STORAGE_PREFIX = fa_test_
# 调试工具,可设置 eruda 或 vconsole
# Debugging tool, can set eruda or vconsole
VITE_APP_DEBUG_TOOL =
# ===== 以下配置仅在测试环境生效 =====
# ===== The following configuration is only effective in the test environment. =====
# 启用假数据
# Enable build fake data
VITE_BUILD_FAKE = true
# 启用 sourcemap
# Enable build sourcemap
VITE_BUILD_SOURCEMAP = true
# 压缩方式,支持 gzip 和 brotli
# Build compression method, supports gzip and brotli
VITE_BUILD_COMPRESS =
# 构建后生成存档,支持 zip 和 tar
# Generate archive after build, supports zip and tar
VITE_BUILD_ARCHIVE =
-16
View File
@@ -1,16 +0,0 @@
{
"$schema": "https://shadcn-vue.com/schema.json",
"style": "new-york-v4",
"typescript": true,
"tailwind": {
"config": "tailwind.config.js",
"css": "src/assets/index.css",
"baseColor": "neutral",
"cssVariables": true
},
"aliases": {
"components": "@/ui/shadcn",
"utils": "@/utils",
"lib": "@/utils"
}
}
-81
View File
@@ -1,81 +0,0 @@
{
"name": "@fantastic-admin/core-ant-design-vue",
"type": "module",
"private": true,
"scripts": {
"dev": "vite",
"build": "vue-tsc -b && vite build",
"build:test": "vue-tsc -b && vite build --mode test",
"serve": "http-server ./dist -o",
"serve:test": "http-server ./dist-test -o",
"svgo": "svgo -f src/assets/icons",
"generate:icons": "fa-iconify-tools",
"lint": "vue-tsc -b"
},
"dependencies": {
"@fantastic-admin/components": "workspace:*",
"@fantastic-admin/composables": "workspace:*",
"@fantastic-admin/hotkeys": "workspace:*",
"@fantastic-admin/settings": "workspace:*",
"@fantastic-admin/types": "workspace:*",
"@vee-validate/zod": "catalog:",
"@vueuse/core": "catalog:",
"@vueuse/integrations": "catalog:",
"@zumer/snapdom": "catalog:",
"ant-design-vue": "catalog:ant-design-vue",
"axios": "catalog:",
"class-variance-authority": "catalog:",
"clsx": "catalog:",
"dayjs": "catalog:",
"eruda": "catalog:",
"es-toolkit": "catalog:",
"mitt": "catalog:",
"nprogress": "catalog:",
"path-browserify": "catalog:",
"path-to-regexp": "catalog:",
"pinia": "catalog:",
"pinia-plugin-persistedstate": "catalog:",
"pinyin-pro": "catalog:",
"qs": "catalog:",
"reka-ui": "catalog:",
"scule": "catalog:",
"tailwind-merge": "catalog:",
"type-fest": "catalog:",
"ua-parser-js": "catalog:",
"vconsole": "catalog:",
"vee-validate": "catalog:",
"vue": "catalog:",
"vue-router": "catalog:",
"zod": "catalog:"
},
"devDependencies": {
"@faker-js/faker": "catalog:",
"@fantastic-admin/copyright": "workspace:*",
"@fantastic-admin/iconify-tools": "workspace:*",
"@iconify/vue": "catalog:",
"@spiriit/vite-plugin-svg-spritemap": "catalog:",
"@types/nprogress": "catalog:",
"@types/path-browserify": "catalog:",
"@types/qs": "catalog:",
"@vitejs/plugin-legacy": "catalog:",
"@vitejs/plugin-vue": "catalog:",
"@vitejs/plugin-vue-jsx": "catalog:",
"@vue/tsconfig": "catalog:",
"http-server": "catalog:",
"postcss": "catalog:",
"postcss-nested": "catalog:",
"sass-embedded": "catalog:",
"svgo": "catalog:",
"unplugin-auto-import": "catalog:",
"unplugin-turbo-console": "catalog:",
"unplugin-vue-components": "catalog:",
"vite": "catalog:",
"vite-plugin-app-loading": "catalog:",
"vite-plugin-archiver": "catalog:",
"vite-plugin-compression2": "catalog:",
"vite-plugin-env-parse": "catalog:",
"vite-plugin-fake-server": "catalog:",
"vite-plugin-vue-devtools": "catalog:",
"vue-tsc": "catalog:"
}
}
-60
View File
@@ -1,60 +0,0 @@
<script setup lang="ts">
import dayjs from '@/utils/dayjs'
import { ua } from '@/utils/ua'
import Provider from './ui/provider/index.vue'
import 'dayjs/locale/zh-cn'
const route = useRoute()
const appSettingsStore = useAppSettingsStore()
const { auth } = useAppAuth()
const { generateTitle } = useAppMenu()
document.body.setAttribute('data-os', ua.getOS().name || '')
const isAuth = computed(() => {
return route.matched.every((item) => {
return auth(item.meta.auth ?? '')
})
})
// 设置网页 title
watch([
() => appSettingsStore.settings.app.dynamicTitle,
() => appSettingsStore.title,
], () => {
nextTick(() => {
if (appSettingsStore.settings.app.dynamicTitle && appSettingsStore.title) {
document.title = `${generateTitle(appSettingsStore.title)} - ${import.meta.env.VITE_APP_TITLE}`
}
else {
document.title = import.meta.env.VITE_APP_TITLE
}
})
}, {
immediate: true,
deep: true,
})
onMounted(() => {
appSettingsStore.setMode(document.documentElement.clientWidth)
dayjs.locale('zh-cn')
window.addEventListener('resize', () => {
appSettingsStore.setMode(document.documentElement.clientWidth)
})
})
</script>
<template>
<Provider>
<RouterView v-slot="{ Component }">
<AppNotSupportedMobile v-if="!appSettingsStore.settings.app.mobile && appSettingsStore.mode === 'mobile'" />
<Component :is="Component" v-else-if="isAuth" />
<AppNotAllowed v-else />
</RouterView>
<AppBackToTop />
<FaToast :theme="appSettingsStore.currentColorScheme" />
<AppSystemInfo />
</Provider>
</template>
@@ -1,146 +0,0 @@
import { faker } from '@faker-js/faker'
import { defineFakeRoute } from 'vite-plugin-fake-server/client'
export default defineFakeRoute([
{
url: '/fake/app/route/list',
method: 'get',
response: () => {
return {
error: '',
status: 1,
data: [
// 主导航
{
meta: {
title: '演示',
icon: 'uim:box',
},
children: [
// 次导航(一级路由)
{
path: '/multilevel_menu_example',
component: 'Layout',
name: 'multilevelMenuExample',
meta: {
title: '多级导航',
icon: 'heroicons-solid:menu-alt-3',
},
children: [
// 次导航(二级路由)
{
path: 'page',
name: 'multilevelMenuExample1',
component: 'multilevel_menu_example/page.vue',
meta: {
title: '导航1',
},
},
{
path: 'level2',
name: 'multilevelMenuExample2',
meta: {
title: '导航2',
},
children: [
// 次导航(三级路由)
{
path: 'page',
name: 'multilevelMenuExample2-1',
component: 'multilevel_menu_example/level2/page.vue',
meta: {
title: '导航2-1',
},
},
{
path: 'level3',
name: 'multilevelMenuExample2-2',
meta: {
title: '导航2-2',
},
children: [
// 次导航(四级路由)
{
path: 'page1',
name: 'multilevelMenuExample2-2-1',
component: 'multilevel_menu_example/level2/level3/page1.vue',
meta: {
title: '导航2-2-1',
},
},
{
path: 'page2',
name: 'multilevelMenuExample2-2-2',
component: 'multilevel_menu_example/level2/level3/page2.vue',
meta: {
title: '导航2-2-2',
},
},
],
},
],
},
],
},
],
},
],
}
},
},
{
url: '/fake/app/account/login',
method: 'post',
response: ({ body }) => {
return {
error: '',
status: 1,
data: {
account: body.account,
token: `${body.account}:${faker.internet.jwt()}`,
avatar: `https://api.dicebear.com/9.x/bottts-neutral/svg?seed=${body.account}`,
},
}
},
},
{
url: '/fake/app/account/permission',
method: 'get',
response: ({ headers }) => {
let permissions: string[] = []
if (headers.token?.indexOf('admin') === 0) {
permissions = [
'pages.general:browse',
'pages.form:browse',
'pages.list:browse',
'pages.shop:browse',
]
}
else if (headers.token?.indexOf('test') === 0) {
permissions = [
'pages.general:browse',
]
}
return {
error: '',
status: 1,
data: {
permissions,
},
}
},
},
{
url: '/fake/app/account/password/edit',
method: 'post',
response: () => {
return {
error: '',
status: 1,
data: {
isSuccess: true,
},
}
},
},
])
-110
View File
@@ -1,110 +0,0 @@
import axios from 'axios'
// import qs from 'qs'
// 请求重试配置
const MAX_RETRY_COUNT = 3 // 最大重试次数
const RETRY_DELAY = 1000 // 重试延迟时间(毫秒)
// 扩展 AxiosRequestConfig 类型
declare module 'axios' {
export interface AxiosRequestConfig {
retry?: boolean
retryCount?: number
fake?: boolean
}
}
const api = axios.create({
baseURL: (import.meta.env.DEV && import.meta.env.VITE_ENABLE_PROXY) ? '/proxy/' : import.meta.env.VITE_APP_API_BASEURL,
timeout: 1000 * 60,
responseType: 'json',
})
api.interceptors.request.use(
(request) => {
// 如果设置了 fake 属性,强制使用 fake 的 baseURL
if (request.fake) {
request.baseURL = '/fake/'
}
// 全局拦截请求发送前提交的参数
const appAccountStore = useAppAccountStore()
// 设置请求头
if (request.headers) {
request.headers['Accept-Language'] = 'zh-CN'
if (appAccountStore.isLogin) {
request.headers.Token = appAccountStore.token
}
}
// 是否将 POST 请求参数进行字符串化处理
if (request.method === 'post') {
// request.data = qs.stringify(request.data, {
// arrayFormat: 'brackets',
// })
}
return request
},
)
// 处理错误信息的函数
function handleError(error: any) {
if (error.status === 401) {
useAppAccountStore().requestLogout()
}
else {
useFaToast().error('Error', {
description: error.message,
})
}
return Promise.reject(error)
}
api.interceptors.response.use(
(response) => {
/**
* 全局拦截请求发送后返回的数据,如果数据有报错则在这做全局的错误提示
* 约定的数据格式:{ status: 1 | 0, error: string, data: object }
* status 只有两种状态,1 表示请求成功,0 表示接口需要登录或者登录状态失效,需要重新登录
* error 只有在请求出错时才会有值,表示错误信息
* data 只有在请求成功时才会有值,表示请求返回的数据
*/
if (typeof response.data === 'object') {
if (response.data.status === 1) {
if (response.data.error) {
useFaToast().warning('Warning', {
description: response.data.error,
})
return Promise.reject(response.data)
}
}
else {
useAppAccountStore().requestLogout()
}
return Promise.resolve(response.data)
}
else {
return Promise.reject(response.data)
}
},
async (error) => {
// 获取请求配置
const config = error.config
// 如果配置不存在或未启用重试,则直接处理错误
if (!config || !config.retry) {
return handleError(error)
}
// 设置重试次数
config.retryCount = config.retryCount || 0
// 判断是否超过重试次数
if (config.retryCount >= MAX_RETRY_COUNT) {
return handleError(error)
}
// 重试次数自增
config.retryCount += 1
// 延迟重试
await new Promise(resolve => setTimeout(resolve, RETRY_DELAY))
// 重新发起请求
return api(config)
},
)
export default api
@@ -1,30 +0,0 @@
import api from '../index'
export default {
// 后端获取路由数据
routeList: () => api.get('app/route/list', {
fake: true,
}),
// 登录
login: (data: {
account: string
password: string
}) => api.post('app/account/login', data, {
fake: true,
}),
// 获取权限
permission: () => api.get('app/account/permission', {
fake: true,
}),
// 修改密码
passwordEdit: (data: {
password: string
newPassword: string
}) => api.post('app/account/password/edit', data, {
fake: true,
}),
}
@@ -1,80 +0,0 @@
/* 页面布局 CSS 变量 */
:root {
color-scheme: light;
/* 头部宽度(默认自适应宽度,可固定宽度,固定宽度后为居中显示) */
--g-header-width: 100%;
/* 头部高度 */
--g-header-height: 60px;
/* 侧边栏宽度 */
--g-main-sidebar-width: 80px;
--g-sub-sidebar-width: 220px;
--g-sub-sidebar-collapse-width: 64px;
/* 侧边栏 Logo 区域高度 */
--g-sidebar-logo-height: 50px;
/* 标签栏高度 */
--g-tabbar-height: 50px;
/* 工具栏高度 */
--g-toolbar-height: 50px;
&.dark {
color-scheme: dark;
}
}
/* 明暗模式过渡动画 */
::view-transition-old(root),
::view-transition-new(root) {
mix-blend-mode: normal;
animation: none;
}
::view-transition-old(root) {
z-index: 0;
}
::view-transition-new(root) {
z-index: 1;
}
.dark {
&::view-transition-old(root) {
z-index: 1;
}
&::view-transition-new(root) {
z-index: 0;
}
}
.disable-color-scheme-transition-duration *,
.disable-color-scheme-transition-duration *::before,
.disable-color-scheme-transition-duration *::after {
transition-duration: 0ms !important;
}
html,
body {
height: 100%;
text-autospace: normal;
}
body {
box-sizing: border-box;
margin: 0;
-webkit-tap-highlight-color: transparent;
}
#app {
height: 100%;
}
/* textarea 字体跟随系统 */
textarea {
font-family: inherit;
}
@@ -1,63 +0,0 @@
#nprogress {
pointer-events: none;
.bar {
position: fixed;
top: 0;
left: 0;
z-index: 3000;
width: 100%;
height: 2px;
background: oklch(var(--primary));
}
.peg {
position: absolute;
right: 0;
display: block;
width: 100px;
height: 100%;
box-shadow: 0 0 10px oklch(var(--primary)), 0 0 5px oklch(var(--primary));
opacity: 1;
transform: rotate(3deg) translate(0, -4px);
}
.spinner {
position: fixed;
top: 11px;
right: 14px;
z-index: 2000;
display: block;
.spinner-icon {
box-sizing: border-box;
width: 18px;
height: 18px;
border: solid 2px transparent;
border-top-color: oklch(var(--primary));
border-left-color: oklch(var(--primary));
border-radius: 50%;
animation: nprogress-spinner 400ms linear infinite;
}
}
}
.nprogress-custom-parent {
position: relative;
overflow: hidden;
#nprogress .spinner,
#nprogress .bar {
position: absolute;
}
}
@keyframes nprogress-spinner {
0% { transform: rotate(0deg); }
100% { transform: rotate(360deg); }
}
@keyframes nprogress-spinner {
0% { transform: rotate(0deg); }
100% { transform: rotate(360deg); }
}
@@ -1,94 +0,0 @@
<script setup lang="ts">
import type { HTMLAttributes } from 'vue'
import { cn } from '@/utils'
import eventBus from '@/utils/eventBus'
import Profile from './profile.vue'
defineOptions({
name: 'AppAccountButton',
})
const props = withDefaults(defineProps<{
onlyAvatar?: boolean
dropdownAlign?: 'start' | 'center' | 'end'
dropdownSide?: 'left' | 'right' | 'top' | 'bottom'
buttonVariant?: 'secondary' | 'ghost'
class?: HTMLAttributes['class']
}>(), {
dropdownAlign: 'end',
dropdownSide: 'right',
buttonVariant: 'ghost',
})
const router = useRouter()
const appSettingsStore = useAppSettingsStore()
const appAccountStore = useAppAccountStore()
const { generateTitle } = useAppMenu()
const profileModal = useFaModal().create({
alignCenter: true,
header: false,
footer: false,
closeOnClickOverlay: false,
closeOnPressEscape: false,
class: 'h-[500px] sm:max-w-xl overflow-hidden',
contentClass: 'min-h-full p-0 flex',
content: () => h(Profile),
})
</script>
<template>
<FaDropdown
:align="dropdownAlign" :side="dropdownSide" :items="[
[
...(appSettingsStore.settings.app.home.enable
? [{ label: generateTitle(appSettingsStore.settings.app.home.title), icon: 'i-mdi:home', handle: () => router.push({ path: appSettingsStore.settings.app.home.fullPath }) }]
: []),
{ label: '个人设置', icon: 'i-mdi:account', handle: () => profileModal.open() },
],
[
...(appSettingsStore.mode === 'pc'
? [{ label: '快捷键', icon: 'i-mdi:keyboard', handle: () => eventBus.emit('global-hotkeys-intro-toggle') }]
: []),
],
[
{
label: '退出登录',
icon: 'i-mdi:logout',
handle: () => appAccountStore.logout(appSettingsStore.settings.app.home.fullPath),
},
],
]" class="flex-center"
>
<template #header>
<div class="flex-center-start gap-2">
<FaAvatar :src="appAccountStore.avatar" :fallback="appAccountStore.account.slice(0, 2)" shape="square" />
<div class="min-w-0 space-y-1">
<div class="text-base lh-none truncate">
{{ appAccountStore.account }}
</div>
<div class="text-xs text-secondary-foreground/50 font-normal">
[ xyz@xyz.com ]
</div>
</div>
</div>
</template>
<FaButton
:variant="buttonVariant" size="icon-sm" :class="cn('flex-center gap-1 p-2', {
'p-1': onlyAvatar,
}, props.class)"
>
<FaAvatar :src="appAccountStore.avatar" :class="cn('size-6', { 'size-full': onlyAvatar })">
<FaIcon name="i-carbon:user-avatar-filled" class="text-secondary-foreground/50 size-6" />
</FaAvatar>
<div v-if="!onlyAvatar" class="flex-center-between flex-1 gap-2 min-w-0">
<div class="text-start flex-1 truncate">
{{ appAccountStore.account }}
</div>
<FaIcon name="i-material-symbols:expand-all-rounded" />
</div>
</FaButton>
</FaDropdown>
</template>
@@ -1,36 +0,0 @@
<script setup lang="ts">
import EditPassword from '@/components/AppAccountForm/edit-password.vue'
const active = ref(0)
const tabs = ref([
{
title: '基本设置',
description: '账号的基本信息,头像、昵称等',
},
{
title: '安全设置',
description: '定期修改密码可以提高帐号安全性',
},
])
</script>
<template>
<div class="min-h-full w-full">
<div class="border-b border-e bg-background flex flex-row right-0 top-0 fixed z-1 overflow-auto md:(flex-col h-full w-40 inset-s-0 bottom-0)">
<div v-for="(tab, index) in tabs" :key="index" class="px-4 py-3 flex-shrink-0 cursor-pointer transition-background-color space-y-2 hover-bg-accent/50" :class="{ 'bg-accent hover-bg-accent!': active === index }" @click="active = index">
<div class="text-base text-accent-foreground leading-tight">
{{ tab.title }}
</div>
<div class="text-xs text-accent-foreground/50">
{{ tab.description }}
</div>
</div>
</div>
<div class="p-10 pt-20 flex-col-center min-h-full md:(ms-40 pt-10)">
<div v-if="active === 0">
请开发者自行扩展
</div>
<EditPassword v-if="active === 1" />
</div>
</div>
</template>
@@ -1,84 +0,0 @@
<script setup lang="ts">
import { toTypedSchema } from '@vee-validate/zod'
import * as z from 'zod'
defineOptions({
name: 'EditPasswordForm',
})
const appAccountStore = useAppAccountStore()
const loading = ref(false)
interface EditPasswordModel {
password: string
newPassword: string
checkPassword: string
}
const model = ref<EditPasswordModel>({
password: '',
newPassword: '',
checkPassword: '',
})
const validationSchema = toTypedSchema(
z.object({
password: z.string().min(1, '请输入原密码'),
newPassword: z.string().min(1, '请输入新密码').min(6, '密码长度为6到18位').max(18, '密码长度为6到18位'),
checkPassword: z.string().min(1, '请确认新密码'),
}).refine(data => data.newPassword === data.checkPassword, {
message: '两次输入的密码不一致',
path: ['checkPassword'],
}),
)
function onSubmit(values: EditPasswordModel) {
loading.value = true
appAccountStore.editPassword(values).then(async () => {
useFaToast().success('模拟修改成功,请重新登录')
appAccountStore.logout()
}).finally(() => {
loading.value = false
})
}
</script>
<template>
<div class="flex-col-stretch-center w-full">
<div class="mb-6 space-y-2">
<h3 class="text-4xl font-bold">
修改密码
</h3>
<p class="text-sm text-muted-foreground lg:text-base">
请输入原密码、新密码和确认密码
</p>
</div>
<FaForm :model="model" :validation-schema="validationSchema" @submit="onSubmit">
<FaFormItem name="password">
<FaInput type="password" placeholder="原密码" class="w-full">
<template #start>
<FaIcon name="i-lucide:lock" />
</template>
</FaInput>
</FaFormItem>
<FaFormItem name="newPassword">
<FaInput type="password" placeholder="新密码" class="w-full">
<template #start>
<FaIcon name="i-lucide:lock" />
</template>
</FaInput>
</FaFormItem>
<FaFormItem name="checkPassword">
<FaInput type="password" placeholder="确认密码" class="w-full">
<template #start>
<FaIcon name="i-lucide:lock" />
</template>
</FaInput>
</FaFormItem>
<FaButton :loading="loading" size="lg" class="mt-8 w-full" type="submit">
保存
</FaButton>
</FaForm>
</div>
</template>
@@ -1,150 +0,0 @@
<script setup lang="ts">
import type { FormExpose } from '@fantastic-admin/components'
import { toTypedSchema } from '@vee-validate/zod'
import * as z from 'zod'
defineOptions({
name: 'LoginForm',
})
const props = defineProps<{
account?: string
}>()
const emits = defineEmits<{
onLogin: [account?: string]
onRegister: [account?: string]
onResetPassword: [account?: string]
}>()
const appAccountStore = useAppAccountStore()
const title = import.meta.env.VITE_APP_TITLE
const loading = ref(false)
// 登录方式,default 账号密码登录,qrcode 扫码登录
const type = ref<'default' | 'qrcode'>('default')
interface LoginModel {
account: string
password: string
remember: boolean
}
const formRef = useTemplateRef<FormExpose<LoginModel>>('formRef')
const model = ref<LoginModel>({
account: props.account ?? localStorage.getItem('login_account') ?? '',
password: '',
remember: localStorage.getItem('login_account') !== null,
})
const validationSchema = toTypedSchema(z.object({
account: z.string().min(1, '请输入用户名'),
password: z.string().min(1, '请输入密码'),
remember: z.boolean(),
}))
function onSubmit(values: LoginModel) {
loading.value = true
appAccountStore.login(values).then(() => {
if (values.remember) {
localStorage.setItem('login_account', values.account)
}
else {
localStorage.removeItem('login_account')
}
emits('onLogin', values.account)
}).finally(() => {
loading.value = false
})
}
async function testAccount(account: string) {
model.value.account = account
model.value.password = '123456'
await formRef.value?.submit()
}
</script>
<template>
<div class="p-12 flex-col-stretch-center min-h-500px w-full">
<div class="mb-6 space-y-2">
<h3 class="text-4xl font-bold">
欢迎使用 👋🏻
</h3>
<p class="text-sm text-muted-foreground lg:text-base">
{{ title }}
</p>
</div>
<div class="mb-4">
<FaTabs
v-model="type" :list="[
{ label: '账号密码登录', value: 'default' },
{ label: '扫码登录', value: 'qrcode' },
]" class="inline-flex"
/>
</div>
<div v-show="type === 'default'">
<FaForm
ref="formRef"
:model="model"
:validation-schema="validationSchema"
@submit="onSubmit"
>
<FaFormItem name="account">
<FaInput type="text" placeholder="用户名" class="w-full">
<template #start>
<FaIcon name="i-lucide:user" />
</template>
</FaInput>
</FaFormItem>
<FaFormItem name="password">
<FaInput type="password" placeholder="密码" class="w-full">
<template #start>
<FaIcon name="i-lucide:lock" />
</template>
</FaInput>
</FaFormItem>
<div class="flex-start-between">
<FaFormItem name="remember" class="min-w-0">
<FaCheckbox>
记住我
</FaCheckbox>
</FaFormItem>
<FaButton variant="link" class="p-0 h-auto" type="button" @click="emits('onResetPassword', model.account)">
忘记密码了?
</FaButton>
</div>
<FaButton :loading="loading" size="lg" class="w-full" type="submit">
登录
</FaButton>
<div class="text-sm mt-4 flex-center gap-2">
<span class="text-secondary-foreground op-50">还没有帐号?</span>
<FaButton variant="link" class="p-0 h-auto" type="button" @click="emits('onRegister', model.account)">
注册新帐号
</FaButton>
</div>
</FaForm>
<div class="mt-4 text-center -mb-4">
<FaDivider>演示账号一键登录</FaDivider>
<div class="space-x-2">
<FaButton variant="default" size="sm" plain @click="testAccount('admin')">
admin
</FaButton>
<FaButton variant="outline" size="sm" plain @click="testAccount('test')">
test
</FaButton>
</div>
</div>
</div>
<div v-show="type === 'qrcode'">
<div class="flex-col-center">
<img src="https://s2.loli.net/2024/04/26/GsahtuIZ9XOg5jr.png" class="h-[250px] w-[250px]">
<div class="text-sm text-secondary-foreground mt-2 op-50">
请使用微信扫码登录
</div>
</div>
</div>
</div>
</template>
@@ -1,93 +0,0 @@
<script setup lang="ts">
import { toTypedSchema } from '@vee-validate/zod'
import * as z from 'zod'
defineOptions({
name: 'RegisterForm',
})
const props = defineProps<{
account?: string
}>()
const emits = defineEmits<{
onLogin: [account?: string]
onRegister: [account?: string]
}>()
const loading = ref(false)
interface RegisterModel {
account: string
password: string
checkPassword: string
}
const model = ref<RegisterModel>({
account: props.account ?? '',
password: '',
checkPassword: '',
})
const validationSchema = toTypedSchema(
z.object({
account: z.string().min(1, '请输入用户名'),
password: z.string().min(1, '请输入密码').min(6, '密码长度为6到18位').max(18, '密码长度为6到18位'),
checkPassword: z.string().min(1, '请再次输入密码'),
}).refine(data => data.password === data.checkPassword, {
message: '两次输入的密码不一致',
path: ['checkPassword'],
}),
)
function onSubmit(values: RegisterModel) {
loading.value = true
emits('onRegister', values.account)
}
</script>
<template>
<div class="p-12 flex-col-stretch-center min-h-500px w-full">
<FaForm :model="model" :validation-schema="validationSchema" @submit="onSubmit">
<div class="mb-8 space-y-2">
<h3 class="text-4xl font-bold">
探索从这里开始 🚀
</h3>
<p class="text-sm text-muted-foreground lg:text-base">
演示系统未提供该功能
</p>
</div>
<FaFormItem name="account">
<FaInput type="text" placeholder="用户名" class="w-full">
<template #start>
<FaIcon name="i-lucide:user" />
</template>
</FaInput>
</FaFormItem>
<FaFormItem name="password">
<FaInput type="password" placeholder="密码" class="w-full">
<template #start>
<FaIcon name="i-lucide:lock" />
</template>
</FaInput>
<FaPasswordStrength :password="model.password" />
</FaFormItem>
<FaFormItem name="checkPassword">
<FaInput type="password" placeholder="确认密码" class="w-full">
<template #start>
<FaIcon name="i-lucide:lock" />
</template>
</FaInput>
</FaFormItem>
<FaButton :loading="loading" size="lg" class="mt-4 w-full" type="submit">
注册
</FaButton>
<div class="text-sm mt-4 flex-center gap-2">
<span class="text-secondary-foreground op-50">已经有帐号?</span>
<FaButton variant="link" class="p-0 h-auto" type="button" @click="emits('onLogin', model.account)">
去登录
</FaButton>
</div>
</FaForm>
</div>
</template>
@@ -1,104 +0,0 @@
<script setup lang="ts">
import { toTypedSchema } from '@vee-validate/zod'
import * as z from 'zod'
defineOptions({
name: 'ResetPasswordForm',
})
const props = defineProps<{
account?: string
}>()
const emits = defineEmits<{
onLogin: [account?: string]
onResetPassword: [account?: string]
}>()
const loading = ref(false)
interface ResetPasswordModel {
account: string
captcha: string
newPassword: string
}
const model = ref<ResetPasswordModel>({
account: props.account ?? '',
captcha: '',
newPassword: '',
})
const validationSchema = toTypedSchema(z.object({
account: z.string().min(1, '请输入用户名'),
captcha: z.string().min(6, '请输入验证码'),
newPassword: z.string().min(1, '请输入新密码').min(6, '密码长度为6到18位').max(18, '密码长度为6到18位'),
}))
function onSubmit(values: ResetPasswordModel) {
loading.value = true
emits('onResetPassword', values.account)
}
const countdown = ref(0)
const countdownInterval = ref(Number.NaN)
function handleSendCaptcha() {
countdown.value = 60
countdownInterval.value = window.setInterval(() => {
countdown.value--
if (countdown.value === 0) {
clearInterval(countdownInterval.value)
}
}, 1000)
}
</script>
<template>
<div class="p-12 flex-col-stretch-center min-h-500px w-full">
<FaForm :model="model" :validation-schema="validationSchema" @submit="onSubmit">
<div class="mb-8 space-y-2">
<h3 class="text-4xl font-bold">
忘记密码了? 🔒
</h3>
<p class="text-sm text-muted-foreground lg:text-base">
演示系统未提供该功能
</p>
</div>
<FaFormItem name="account">
<FaInput type="text" placeholder="用户名" class="w-full">
<template #start>
<FaIcon name="i-lucide:user" />
</template>
</FaInput>
</FaFormItem>
<FaFormItem name="captcha" :auto-bind="false">
<div class="flex-start-between gap-2">
<FaInputOTP
v-model="model.captcha"
name="captcha"
:length="6"
class="border-destructive"
/>
<FaButton variant="outline" type="button" :disabled="countdown > 0" class="px-4 flex-1" @click="handleSendCaptcha">
{{ countdown === 0 ? '发送验证码' : `${countdown} 秒后重发` }}
</FaButton>
</div>
</FaFormItem>
<FaFormItem name="newPassword">
<FaInput type="password" placeholder="新密码" class="w-full">
<template #start>
<FaIcon name="i-lucide:lock" />
</template>
</FaInput>
</FaFormItem>
<FaButton :loading="loading" size="lg" class="mt-4 w-full" type="submit">
确认
</FaButton>
<div class="text-sm mt-4 flex-center gap-2">
<FaButton variant="link" class="p-0 h-auto" type="button" @click="emits('onLogin', model.account)">
去登录
</FaButton>
</div>
</FaForm>
</div>
</template>
@@ -1,21 +0,0 @@
<script setup lang="ts">
defineOptions({
name: 'AppAuth',
})
const props = defineProps<{
value: string | string[]
all?: boolean
}>()
const isCheck = computed(() => {
return props.all
? useAppAuth().authAll(typeof props.value === 'string' ? [props.value] : props.value)
: useAppAuth().auth(props.value)
})
</script>
<template>
<slot v-if="isCheck" />
<slot v-else name="no-auth" />
</template>
@@ -1,69 +0,0 @@
<script setup lang="ts">
import { useTimeoutFn } from '@vueuse/core'
defineOptions({
name: 'AppBackToTop',
})
const transitionClass = {
enterActiveClass: 'ease-out duration-300',
enterFromClass: 'opacity-0 translate-y-4 lg-translate-y-0 lg-scale-95',
enterToClass: 'opacity-100 translate-y-0 lg-scale-100',
leaveActiveClass: 'ease-in duration-200',
leaveFromClass: 'opacity-100 translate-y-0 lg-scale-100',
leaveToClass: 'opacity-0 translate-y-4 lg-translate-y-0 lg-scale-95',
}
onMounted(() => {
window.addEventListener('scroll', handleScroll)
handleScroll()
})
onBeforeUnmount(() => {
window.removeEventListener('scroll', handleScroll)
})
let timeout: (() => void) | undefined
const show = ref(false)
const scrollTop = ref(0)
function handleScroll() {
scrollTop.value = document.documentElement.scrollTop
}
watch(scrollTop, (val) => {
if (val >= 200) {
handleMouseenter()
handleMouseleave()
}
})
function handleMouseenter() {
timeout?.()
// 此处setTimeout是为了避免移动端下和click事件同时触发
setTimeout(() => {
show.value = true
}, 0)
}
function handleMouseleave() {
;({ stop: timeout } = useTimeoutFn(() => {
show.value = false
}, 2000))
}
function handleBackToTop() {
show.value && document.documentElement.scrollTo({
top: 0,
behavior: 'smooth',
})
}
</script>
<template>
<Teleport to="body">
<Transition v-bind="transitionClass">
<FaButton v-if="scrollTop >= 200" variant="outline" size="icon" class="rounded-full h-12 w-12 transition-all inset-b-4 fixed z-2000 dark:bg-background -inset-e-9 dark:hover:bg-background/50" :class="{ 'inset-e-3!': show }" @mouseenter="handleMouseenter" @mouseleave="handleMouseleave" @click="handleBackToTop">
<FaIcon name="i-icon-park-outline:to-top-one" class="size-6" />
</FaButton>
</Transition>
</Teleport>
</template>
@@ -1,20 +0,0 @@
<script setup lang="ts">
defineOptions({
name: 'AppCopyright',
})
const route = useRoute()
const appSettingsStore = useAppSettingsStore()
</script>
<template>
<footer v-if="route.meta.copyright ?? appSettingsStore.settings.app.copyright.enable" class="text-sm text-secondary-foreground/50 my-4 px-4 flex flex-wrap items-center justify-center">
<span class="px-1">Copyright</span>
<FaIcon name="i-ri:copyright-line" class="size-5" />
<span v-if="appSettingsStore.settings.app.copyright.dates" class="px-1">{{ appSettingsStore.settings.app.copyright.dates }}</span>
<template v-if="appSettingsStore.settings.app.copyright.company">
<a v-if="appSettingsStore.settings.app.copyright.website" :href="appSettingsStore.settings.app.copyright.website" target="_blank" rel="noopener" class="px-1 text-center no-underline transition-colors hover-text-secondary-foreground">{{ appSettingsStore.settings.app.copyright.company }}</a>
<span v-else class="px-1">{{ appSettingsStore.settings.app.copyright.company }}</span>
</template>
</footer>
</template>
@@ -1,53 +0,0 @@
<script setup lang="ts">
defineOptions({
name: 'AppNotAllowed',
})
const route = useRoute()
const router = useRouter()
const appSettingsStore = useAppSettingsStore()
const appTabbarStore = useAppTabbarStore()
onMounted(() => {
if (appSettingsStore.settings.topbar.tabbar) {
appTabbarStore.remove(route.meta.activeMenu || route.fullPath)
}
})
function goBack() {
router.push(appSettingsStore.settings.app.home.fullPath)
}
</script>
<template>
<div class="flex flex-col h-full">
<div class="flex h-[5vh] lg:h-[10vh]">
<div class="w-[5vh] lg:w-[10vh]" />
<div class="border-inline border-dashed flex-1" />
<div class="w-[5vh] lg:w-[10vh]" />
</div>
<div class="border-block border-dashed flex flex-1">
<div class="w-[5vh] lg:w-[10vh]" />
<div class="border-inline border-dashed flex-center flex-1 relative">
<div class="p-4 flex-col-center gap-4 lg:p-12">
<h1 class="text-6xl font-bold m-0 lg:text-9xl">
403
</h1>
<div class="text-xl text-secondary-foreground/50 mx-0 text-center">
抱歉,你无权访问该页面
</div>
<FaButton variant="link" class="text-unset" @click="goBack">
返回主页
</FaButton>
</div>
</div>
<div class="w-[5vh] lg:w-[10vh]" />
</div>
<div class="flex h-[5vh] lg:h-[10vh]">
<div class="w-[5vh] lg:w-[10vh]" />
<div class="border-inline border-dashed flex-1" />
<div class="w-[5vh] lg:w-[10vh]" />
</div>
</div>
</template>
@@ -1,34 +0,0 @@
<script setup lang="ts">
defineOptions({
name: 'AppNotSupportedMobile',
})
</script>
<template>
<div class="flex flex-col h-full">
<div class="flex h-[5vh] lg:h-[10vh]">
<div class="w-[5vh] lg:w-[10vh]" />
<div class="border-inline border-dashed flex-1" />
<div class="w-[5vh] lg:w-[10vh]" />
</div>
<div class="border-block border-dashed flex flex-1">
<div class="w-[5vh] lg:w-[10vh]" />
<div class="border-inline border-dashed flex-center flex-1 relative">
<div class="p-4 flex-col-center gap-4 lg:p-12">
<h1 class="text-6xl font-bold m-0 lg:text-9xl">
<FaIcon name="i-tdesign:mobile-blocked-filled" />
</h1>
<div class="text-xl text-secondary-foreground/50 mx-0 text-center">
抱歉,本网站不支持移动设备访问,请切换到桌面设备
</div>
</div>
</div>
<div class="w-[5vh] lg:w-[10vh]" />
</div>
<div class="flex h-[5vh] lg:h-[10vh]">
<div class="w-[5vh] lg:w-[10vh]" />
<div class="border-inline border-dashed flex-1" />
<div class="w-[5vh] lg:w-[10vh]" />
</div>
</div>
</template>
@@ -1,72 +0,0 @@
<script setup lang="ts">
import eventBus from '@/utils/eventBus'
defineOptions({
name: 'AppSystemInfo',
})
const isShow = ref(false)
const { pkg, lastBuildTime } = __SYSTEM_INFO__
onMounted(() => {
eventBus.on('global-system-info-open', () => {
isShow.value = true
})
})
onUnmounted(() => {
eventBus.off('global-system-info-open')
})
</script>
<template>
<FaDrawer v-model="isShow" title="系统信息" :footer="false">
<div v-if="pkg.version">
<FaDivider>
版本号
</FaDivider>
<div class="text-lg font-bold font-sans text-center">
{{ pkg.version }}
</div>
</div>
<div>
<FaDivider>
最后编译时间
</FaDivider>
<div class="text-lg font-bold font-sans text-center">
{{ lastBuildTime }}
</div>
</div>
<div>
<FaDivider>
生产环境依赖
</FaDivider>
<ul class="text-sm list-none">
<li v-for="(val, key) in (pkg.dependencies as object)" :key="key" class="px-2 py-1.5 rounded-lg flex items-center justify-between hover-bg-secondary">
<div class="font-bold">
{{ key }}
</div>
<div class="font-sans">
{{ val }}
</div>
</li>
</ul>
</div>
<div>
<FaDivider>
开发环境依赖
</FaDivider>
<ul class="text-sm list-none">
<li v-for="(val, key) in (pkg.devDependencies as object)" :key="key" class="px-2 py-1.5 rounded-lg flex items-center justify-between hover-bg-secondary">
<div class="font-bold">
{{ key }}
</div>
<div class="font-sans">
{{ val }}
</div>
</li>
</ul>
</div>
</FaDrawer>
</template>
@@ -1,27 +0,0 @@
export function useAppMenu() {
const router = useRouter()
const appSettingsStore = useAppSettingsStore()
const appMenuStore = useAppMenuStore()
function generateTitle(title: string | (() => any) = '[ 无标题 ]') {
return typeof title === 'function'
? title()
: title
}
function switchTo(index: number) {
appMenuStore.setActived(index)
if (
appSettingsStore.settings.menu.mainMenuClickMode === 'jump'
|| (appSettingsStore.settings.menu.mainMenuClickMode === 'smart' && appMenuStore.sidebarMenusHasOnlyMenu)
) {
router.push(appMenuStore.sidebarMenusFirstDeepestPath)
}
}
return {
generateTitle,
switchTo,
}
}
@@ -1,57 +0,0 @@
import type { HotkeyBinding } from '@fantastic-admin/hotkeys'
/**
* 业务扩展快捷键 id
*
* 使用方式:
*
* export const EXT_HOTKEY_ID = {
* demoOpen: 'demo.open',
* } as const
*/
export const EXT_HOTKEY_ID = {} as const
type ExtendHotkeyId = typeof EXT_HOTKEY_ID[keyof typeof EXT_HOTKEY_ID]
/**
* 业务扩展全局快捷键
*
* 示例:
*
* export const extendGlobalHotkeyBindings = [
* {
* id: EXT_HOTKEY_ID.demoOpen,
* keys: ['command+j', 'ctrl+j'],
* enabled: ctx => ctx.settings.toolbar.menuSearch.enable,
* help: {
* group: 'global',
* titleKey: 'global.demoOpen',
* order: 90,
* visible: ctx => ctx.settings.toolbar.menuSearch.enable,
* displayKeys: {
* default: ['Ctrl', 'J'],
* mac: ['⌘', 'J'],
* },
* },
* },
* ] satisfies HotkeyBinding<ExtendHotkeyId>[]
*/
export const extendGlobalHotkeyBindings = [] satisfies HotkeyBinding<ExtendHotkeyId>[]
/**
* 业务扩展局部快捷键
*
* 示例:
*
* export const extendScopedHotkeyBindings = [
* {
* id: EXT_HOTKEY_ID.demoConfirm,
* keys: ['enter'],
* },
* {
* id: EXT_HOTKEY_ID.demoClose,
* keys: ['esc'],
* },
* ] satisfies HotkeyBinding<ExtendHotkeyId>[]
*/
export const extendScopedHotkeyBindings = [] satisfies HotkeyBinding<ExtendHotkeyId>[]
@@ -1,41 +0,0 @@
import type {
HotkeyBinding,
HotkeyContextBase,
HotkeyDisplayKeys,
HotkeyHandler,
HotkeyHandlerArgs,
HotkeyHandlersMap,
HotkeyHelpGroup,
HotkeyHelpMeta,
} from '@fantastic-admin/hotkeys'
import { createHotkeys } from '@fantastic-admin/hotkeys'
import { EXT_HOTKEY_ID, extendGlobalHotkeyBindings, extendScopedHotkeyBindings } from './extend'
const appHotkeys = createHotkeys({
extendIds: EXT_HOTKEY_ID,
extendGlobalHotkeyBindings,
extendScopedHotkeyBindings,
getContext: () => ({
settings: useAppSettingsStore().settings,
}),
})
export const HOTKEY_ID = appHotkeys.HOTKEY_ID
export const hotkeyIds = appHotkeys.hotkeyIds
export const globalHotkeyBindings = appHotkeys.globalHotkeyBindings
export const menuSearchHotkeyBindings = appHotkeys.menuSearchHotkeyBindings
export const hotkeyBindings = appHotkeys.hotkeyBindings
export const useHotkey = appHotkeys.useHotkey
export const useHotkeyBindings = appHotkeys.useHotkeyBindings
export type HotkeyId = typeof HOTKEY_ID[keyof typeof HOTKEY_ID]
export type {
HotkeyBinding,
HotkeyContextBase,
HotkeyDisplayKeys,
HotkeyHandler,
HotkeyHandlerArgs,
HotkeyHandlersMap,
HotkeyHelpGroup,
HotkeyHelpMeta,
}
File diff suppressed because one or more lines are too long
@@ -1,440 +0,0 @@
<script setup lang="ts">
import { diffTwoObj, setSettings } from '@fantastic-admin/settings'
import { useClipboard } from '@vueuse/core'
import eventBus from '@/utils/eventBus'
defineOptions({
name: 'AppSetting',
})
const route = useRoute()
const appSettingsStore = useAppSettingsStore()
const settingsDefault = setSettings({})
const appMenuStore = useAppMenuStore()
const isShow = ref(false)
const themeRadius = computed<number[]>({
get() {
return [appSettingsStore.settings.theme.radius]
},
set(value) {
appSettingsStore.settings.theme.radius = value[0]
},
})
watch(() => appSettingsStore.settings.menu.mode, (value) => {
if (value === 'single') {
appMenuStore.setActived(0)
}
else {
appMenuStore.setActived(route.fullPath)
}
})
onMounted(() => {
eventBus.on('global-app-setting-toggle', () => {
isShow.value = !isShow.value
})
})
const { copy, copied, isSupported } = useClipboard({ legacy: true })
function handleCopy() {
copy(JSON.stringify(diffTwoObj(settingsDefault, appSettingsStore.settings), null, 2))
}
</script>
<template>
<FaModal v-model="isShow" title="应用配置" description="在生产环境中应关闭该模块" :footer="isSupported" :destroy-on-close="false" class="sm:max-w-4xl" content-class="bg-[var(--g-main-area-bg)] transition-background-color">
<div
:class="{
'columns-1': appSettingsStore.mode === 'mobile',
'columns-2': appSettingsStore.mode === 'pc',
}"
>
<FaPageMain title="主题" class="m-0 mb-4 break-inside-avoid light:border-none" title-class="font-bold" main-class="space-y-4">
<div class="setting-item">
<div class="label">
颜色方案
</div>
<FaButtonGroup>
<FaButton
v-for="(item, index) in [
{ icon: 'i-ri:sun-line', value: 'light' },
{ icon: 'i-ri:moon-line', value: 'dark' },
{ icon: 'i-codicon:color-mode', value: '' },
]" :key="index" :variant="appSettingsStore.settings.theme.colorScheme === item.value ? 'default' : 'outline'" size="sm" :class="{ 'z-1': appSettingsStore.settings.theme.colorScheme === item.value }" @click="appSettingsStore.settings.theme.colorScheme = (item.value as any)"
>
<FaIcon :name="item.icon" />
</FaButton>
</FaButtonGroup>
</div>
<div class="setting-item">
<div class="label">
圆角
</div>
<FaSlider v-model="themeRadius" :min="0" :max="1" :step="0.25" class="w-1/2" />
</div>
<div class="setting-item">
<div class="label">
色弱模式
</div>
<FaSwitch v-model="appSettingsStore.settings.theme.colorAmblyopia" />
</div>
</FaPageMain>
<FaPageMain v-if="appSettingsStore.mode === 'pc'" title="导航菜单" class="m-0 mb-4 break-inside-avoid light:border-none" title-class="font-bold" main-class="space-y-4">
<div class="menu-mode">
<FaTooltip text="侧边栏模式 (有主导航菜单)" :delay="500">
<FaButton variant="outline" class="mode mode-side" :class="{ active: appSettingsStore.settings.menu.mode === 'side' }" @click="appSettingsStore.settings.menu.mode = 'side'">
<div class="mode-container" />
</FaButton>
</FaTooltip>
<FaTooltip text="顶部模式" :delay="500">
<FaButton variant="outline" class="mode mode-head" :class="{ active: appSettingsStore.settings.menu.mode === 'head' }" @click="appSettingsStore.settings.menu.mode = 'head'">
<div class="mode-container" />
</FaButton>
</FaTooltip>
<FaTooltip text="侧边栏模式 (无主导航菜单)" :delay="500">
<FaButton variant="outline" class="mode mode-single" :class="{ active: appSettingsStore.settings.menu.mode === 'single' }" @click="appSettingsStore.settings.menu.mode = 'single'">
<div class="mode-container" />
</FaButton>
</FaTooltip>
</div>
<div class="setting-item">
<div class="label" :class="{ 'op-50': !['single', 'side', 'head'].includes(appSettingsStore.settings.menu.mode) }">
点击主导航菜单
<FaTooltip text="智能模式下默认执行切换操作,当次导航菜单只有一个可访问的导航菜单时执行跳转操作">
<FaIcon name="i-ri:question-line" class="text-base text-orange cursor-help" />
</FaTooltip>
</div>
<FaButtonGroup>
<FaButton
v-for="(item, index) in [
{ label: '切换', value: 'switch' },
{ label: '跳转', value: 'jump' },
{ label: '智能', value: 'smart' },
]" :key="index" :variant="appSettingsStore.settings.menu.mainMenuClickMode === item.value ? 'default' : 'outline'" size="sm" :disabled="!['single', 'side', 'head'].includes(appSettingsStore.settings.menu.mode)" :class="{ 'z-1': appSettingsStore.settings.menu.mainMenuClickMode === item.value }" @click="appSettingsStore.settings.menu.mainMenuClickMode = (item.value as any)"
>
{{ item.label }}
</FaButton>
</FaButtonGroup>
</div>
<div class="setting-item">
<div class="label">
次导航菜单唯一展开
</div>
<FaSwitch v-model="appSettingsStore.settings.menu.subMenuUniqueExpand" />
</div>
<div class="setting-item">
<div class="label">
次导航菜单收起
</div>
<FaSwitch v-model="appSettingsStore.settings.menu.subMenuCollapse" />
</div>
<div v-if="appSettingsStore.mode === 'pc'" class="setting-item">
<div class="label">
次导航菜单展开/收起按钮
</div>
<FaSwitch v-model="appSettingsStore.settings.menu.subMenuCollapseButton" />
</div>
<div class="setting-item">
<div class="label" :class="{ 'op-50': appSettingsStore.settings.menu.mode === 'single' }">
快捷键
</div>
<FaSwitch v-model="appSettingsStore.settings.menu.hotkeys" :disabled="appSettingsStore.settings.menu.mode === 'single'" />
</div>
</FaPageMain>
<FaPageMain title="顶栏" class="m-0 mb-4 break-inside-avoid light:border-none" title-class="font-bold" main-class="space-y-4">
<div class="setting-item">
<div class="label">
标签栏
</div>
<FaSwitch v-model="appSettingsStore.settings.topbar.tabbar" />
</div>
<div class="setting-item">
<div class="label">
工具栏
</div>
<FaSwitch v-model="appSettingsStore.settings.topbar.toolbar" />
</div>
<div class="setting-item">
<div class="label">
模式
</div>
<FaButtonGroup>
<FaButton
v-for="(item, index) in [
{ label: '静态', value: 'static' },
{ label: '固定', value: 'fixed' },
{ label: '粘性', value: 'sticky' },
]" :key="index" :variant="appSettingsStore.settings.topbar.mode === item.value ? 'default' : 'outline'" size="sm" :class="{ 'z-1': appSettingsStore.settings.topbar.mode === item.value }" :disabled="!appSettingsStore.settings.topbar.tabbar && !appSettingsStore.settings.topbar.toolbar" @click="appSettingsStore.settings.topbar.mode = (item.value as any)"
>
{{ item.label }}
</FaButton>
</FaButtonGroup>
</div>
</FaPageMain>
<FaPageMain title="标签栏" class="m-0 mb-4 break-inside-avoid light:border-none" title-class="font-bold" main-class="space-y-4">
<div class="setting-item">
<div class="label">
显示图标
</div>
<FaSwitch v-model="appSettingsStore.settings.tabbar.icon" />
</div>
<div class="setting-item">
<div class="label">
快捷键
</div>
<FaSwitch v-model="appSettingsStore.settings.tabbar.hotkeys" />
</div>
</FaPageMain>
<FaPageMain title="工具栏" class="m-0 mb-4 break-inside-avoid light:border-none" title-class="font-bold" main-class="space-y-4">
<div v-if="appSettingsStore.mode === 'pc'" class="setting-item">
<div class="label">
<FaIcon name="i-ic:twotone-double-arrow" />
面包屑导航
</div>
<FaSwitch v-model="appSettingsStore.settings.toolbar.breadcrumb" />
</div>
<div class="setting-item">
<div class="label">
<FaIcon name="i-ri:search-line" />
导航搜索
</div>
<FaSwitch v-model="appSettingsStore.settings.toolbar.menuSearch.enable" />
</div>
<div class="ps-8 space-y-4">
<div class="setting-item">
<div class="label" :class="{ 'op-50': !appSettingsStore.settings.toolbar.menuSearch.enable }">
快捷键
</div>
<FaSwitch v-model="appSettingsStore.settings.toolbar.menuSearch.hotkeys" :disabled="!appSettingsStore.settings.toolbar.menuSearch.enable" />
</div>
</div>
<div v-if="appSettingsStore.mode === 'pc'" class="setting-item">
<div class="label">
<FaIcon name="i-ri:fullscreen-line" />
全屏
</div>
<FaSwitch v-model="appSettingsStore.settings.toolbar.fullscreen" />
</div>
<div class="setting-item">
<div class="label">
<FaIcon name="i-iconoir:refresh-double" />
页面刷新
<FaTooltip text="重新载入当前页面,并且不刷新浏览器">
<FaIcon name="i-ri:question-line" class="text-base text-orange cursor-help" />
</FaTooltip>
</div>
<FaSwitch v-model="appSettingsStore.settings.toolbar.pageReload" />
</div>
<div class="setting-item">
<div class="label">
<FaIcon name="i-ri:sun-line" />
颜色主题
</div>
<FaSwitch v-model="appSettingsStore.settings.toolbar.colorScheme" />
</div>
</FaPageMain>
<FaPageMain title="页面" class="m-0 mb-4 break-inside-avoid light:border-none" title-class="font-bold" main-class="space-y-4">
<div class="setting-item">
<div class="label">
载入进度条
<FaTooltip text="路由跳转时会在页面顶部显示进度条,该进度仅为模拟效果,并非真实加载进度">
<FaIcon name="i-ri:question-line" class="text-base text-orange cursor-help" />
</FaTooltip>
</div>
<FaSwitch v-model="appSettingsStore.settings.page.progress" />
</div>
</FaPageMain>
<FaPageMain title="应用" class="m-0 mb-4 break-inside-avoid light:border-none" title-class="font-bold" main-class="space-y-4">
<div class="p-4 pb-4 pt-14 border rounded-lg relative space-y-4">
<div class="font-bold px-4 py-2 border-b border-e rounded-rb-lg inset-s-0 inset-t-0 absolute">
账号
</div>
<div class="setting-item">
<div class="label">
权限验证
</div>
<FaSwitch v-model="appSettingsStore.settings.app.account.auth" />
</div>
</div>
<div class="setting-item">
<div class="label">
动态标题
<FaTooltip text="开启时页面标题会显示当前路由标题,格式为“页面标题 - 网站名称”;关闭时则显示网站名称,网站名称在项目根目录下 .env.* 文件里配置">
<FaIcon name="i-ri:question-line" class="text-base text-orange cursor-help" />
</FaTooltip>
</div>
<FaSwitch v-model="appSettingsStore.settings.app.dynamicTitle" />
</div>
<div class="setting-item">
<div class="label">
哀悼模式
<FaTooltip text="网站整体变灰色">
<FaIcon name="i-ri:question-line" class="text-base text-orange cursor-help" />
</FaTooltip>
</div>
<FaSwitch v-model="appSettingsStore.settings.app.rip" />
</div>
<div class="setting-item">
<div class="label">
移动端访问
<FaTooltip text="关闭后,将禁用移动端访问">
<FaIcon name="i-ri:question-line" class="text-base text-orange cursor-help" />
</FaTooltip>
</div>
<FaSwitch v-model="appSettingsStore.settings.app.mobile" />
</div>
<div class="p-4 pb-4 pt-14 border rounded-lg relative space-y-4">
<div class="font-bold px-4 py-2 border-b border-e rounded-rb-lg inset-s-0 inset-t-0 absolute">
主页
</div>
<div class="setting-item">
<div class="label">
启用
<FaTooltip text="登录后默认进入主页,否则默认进入第一个导航页面">
<FaIcon name="i-ri:question-line" class="text-base text-orange cursor-help" />
</FaTooltip>
</div>
<FaSwitch v-model="appSettingsStore.settings.app.home.enable" />
</div>
<div class="setting-item">
<div class="label">
标题
<FaTooltip text="用于设置首页显示标题,支持直接输入简体中文内容">
<FaIcon name="i-ri:question-line" class="text-base text-orange cursor-help" />
</FaTooltip>
</div>
<FaInput v-model="appSettingsStore.settings.app.home.title" />
</div>
</div>
<div class="p-4 pb-4 pt-14 border rounded-lg relative space-y-4">
<div class="font-bold px-4 py-2 border-b border-e rounded-rb-lg inset-s-0 inset-t-0 absolute">
版权
</div>
<div class="setting-item">
<div class="label">
启用
</div>
<FaSwitch v-model="appSettingsStore.settings.app.copyright.enable" />
</div>
<div class="setting-item">
<div class="label">
日期
</div>
<FaInput v-model="appSettingsStore.settings.app.copyright.dates" :disabled="!appSettingsStore.settings.app.copyright.enable" />
</div>
<div class="setting-item">
<div class="label">
公司
</div>
<FaInput v-model="appSettingsStore.settings.app.copyright.company" :disabled="!appSettingsStore.settings.app.copyright.enable" />
</div>
<div class="setting-item">
<div class="label">
网站
</div>
<FaInput v-model="appSettingsStore.settings.app.copyright.website" :disabled="!appSettingsStore.settings.app.copyright.enable" />
</div>
</div>
</FaPageMain>
</div>
<template #footer>
<div class="w-full">
<div class="text-sm/6 c-rose mb-2 px-4 py-2 text-center rounded-lg bg-rose/20">
在此处调整配置只是临时生效,要想真正应用于项目,请点击「复制配置」按钮,并粘贴到
<code class="text-sm font-mono font-semibold px-[0.3rem] py-[0.2rem] rounded bg-muted relative">src/settings.ts</code>
文件中。
</div>
<FaButton class="w-full" @click="handleCopy">
<FaIcon :name="copied ? 'i-tabler:clipboard-check' : 'i-tabler:clipboard'" class="size-5" />
复制配置
</FaButton>
</div>
</template>
</FaModal>
</template>
<style scoped>
.menu-mode {
--uno: flex items-center justify-center gap-4;
.mode {
--uno: relative w-16 h-12;
&.active {
--uno: ring-primary ring-2;
}
&::before,
&::after,
.mode-container {
--uno: absolute pointer-events-none;
}
&::before {
--uno: content-empty bg-primary;
}
&::after {
--uno: content-empty bg-primary/60;
}
.mode-container {
--uno: bg-primary/20 border-width-1.5 border-dashed border-primary;
&::before {
--uno: content-empty absolute w-full h-full;
}
}
&-side {
&::before {
--uno: top-2 bottom-2 start-2 w-2 rounded-ss-1 rounded-es-1;
}
&::after {
--uno: top-2 bottom-2 start-4.5 w-3;
}
.mode-container {
--uno: inset-t-2 inset-e-2 inset-b-2 inset-s-8 rounded-se-1 rounded-ee-1;
}
}
&-head {
&::before {
--uno: top-2 start-2 end-2 h-2 rounded-ss-1 rounded-se-1;
}
&::after {
--uno: top-4.5 start-2 bottom-2 w-3 rounded-es-1;
}
.mode-container {
--uno: inset-t-4.5 inset-e-2 inset-b-2 inset-s-5.5 rounded-ee-1;
}
}
&-single {
&::after {
--uno: top-2 start-2 bottom-2 w-3 rounded-ss-1 rounded-es-1;
}
.mode-container {
--uno: inset-t-2 inset-e-2 inset-b-2 inset-s-5.5 rounded-se-1 rounded-ee-1;
}
}
}
}
.setting-item {
--uno: flex items-center justify-between gap-4;
.label {
--uno: flex items-center flex-shrink-0 gap-2 text-sm;
}
}
</style>
@@ -1,21 +0,0 @@
<template>
<div class="text-sm flex items-center">
<slot />
</div>
</template>
<style scoped>
:deep(.breadcrumb-item) {
&:first-child {
.separator {
display: none;
}
}
&:last-child {
.text {
opacity: 1;
}
}
}
</style>
@@ -1,38 +0,0 @@
<script setup lang="ts">
import type { RouteLocationRaw } from 'vue-router'
const props = withDefaults(
defineProps<{
to?: RouteLocationRaw
replace?: boolean
separator?: string
}>(),
{
separator: '/',
},
)
const router = useRouter()
function onClick() {
if (props.to) {
props.replace ? router.replace(props.to) : router.push(props.to)
}
}
</script>
<template>
<div class="breadcrumb-item text-foreground flex items-center">
<span class="separator mx-2">
{{ separator }}
</span>
<span
class="text opacity-60 flex items-center"
:class="{
'is-link cursor-pointer transition-opacity hover-opacity-100': !!props.to,
}" @click="onClick"
>
<slot />
</span>
</div>
</template>
@@ -1,253 +0,0 @@
<script setup lang="ts">
import type { CSSProperties } from 'vue'
type SnapSide = 'left' | 'right'
const EDGE_OFFSET = 4
const DRAG_THRESHOLD = 8
const DEFAULT_BUTTON_SIZE = 40
const appSettingsStore = useAppSettingsStore()
const buttonRef = useTemplateRef('buttonRef')
const buttonState = ref({
initialized: false,
width: DEFAULT_BUTTON_SIZE,
height: DEFAULT_BUTTON_SIZE,
left: EDGE_OFFSET,
top: EDGE_OFFSET,
snapSide: 'left' as SnapSide,
})
const dragState = ref({
pointerId: -1,
active: false,
moved: false,
suppressClick: false,
startX: 0,
startY: 0,
startLeft: 0,
startTop: 0,
})
const buttonStyle = computed<CSSProperties>(() => ({
left: buttonState.value.initialized
? `${buttonState.value.left}px`
: `${EDGE_OFFSET}px`,
right: buttonState.value.initialized
? 'auto'
: 'auto',
top: buttonState.value.initialized
? `${buttonState.value.top}px`
: 'auto',
bottom: buttonState.value.initialized
? 'auto'
: `${EDGE_OFFSET}px`,
transition: dragState.value.active ? 'none' : 'left 200ms ease, top 200ms ease',
willChange: 'left, top',
}))
function getButtonElement() {
const el = buttonRef.value?.$el
return el instanceof HTMLElement ? el : null
}
function clamp(value: number, min: number, max: number) {
return Math.min(Math.max(value, min), max)
}
function getViewportBounds() {
return {
minLeft: EDGE_OFFSET,
maxLeft: Math.max(EDGE_OFFSET, window.innerWidth - buttonState.value.width - EDGE_OFFSET),
minTop: EDGE_OFFSET,
maxTop: Math.max(EDGE_OFFSET, window.innerHeight - buttonState.value.height - EDGE_OFFSET),
}
}
function syncButtonMetrics() {
const rect = getButtonElement()?.getBoundingClientRect()
if (!rect) {
return
}
buttonState.value.width = rect.width || DEFAULT_BUTTON_SIZE
buttonState.value.height = rect.height || DEFAULT_BUTTON_SIZE
}
function setButtonPosition(left = buttonState.value.left, top = buttonState.value.top) {
const bounds = getViewportBounds()
buttonState.value.left = clamp(left, bounds.minLeft, bounds.maxLeft)
buttonState.value.top = clamp(top, bounds.minTop, bounds.maxTop)
}
function snapToSide(side: SnapSide) {
const bounds = getViewportBounds()
buttonState.value.snapSide = side
buttonState.value.left = side === 'left' ? bounds.minLeft : bounds.maxLeft
buttonState.value.top = clamp(buttonState.value.top, bounds.minTop, bounds.maxTop)
}
function syncPositionToViewport() {
syncButtonMetrics()
const bounds = getViewportBounds()
buttonState.value.top = clamp(buttonState.value.top, bounds.minTop, bounds.maxTop)
buttonState.value.left = buttonState.value.snapSide === 'right'
? bounds.maxLeft
: clamp(buttonState.value.left, bounds.minLeft, bounds.maxLeft)
}
async function initializeButtonPosition() {
if (appSettingsStore.mode !== 'mobile') {
return
}
await nextTick()
syncButtonMetrics()
if (!getButtonElement()) {
return
}
if (!buttonState.value.initialized) {
const bounds = getViewportBounds()
buttonState.value.snapSide = 'left'
buttonState.value.left = bounds.minLeft
buttonState.value.top = bounds.maxTop
buttonState.value.initialized = true
}
setButtonPosition()
}
function handlePointerDown(event: PointerEvent) {
if (!event.isPrimary || (event.pointerType === 'mouse' && event.button !== 0)) {
return
}
const target = event.currentTarget
if (!(target instanceof HTMLElement)) {
return
}
syncButtonMetrics()
dragState.value.pointerId = event.pointerId
dragState.value.active = true
dragState.value.moved = false
dragState.value.startX = event.clientX
dragState.value.startY = event.clientY
dragState.value.startLeft = buttonState.value.left
dragState.value.startTop = buttonState.value.top
target.setPointerCapture?.(event.pointerId)
}
function handlePointerMove(event: PointerEvent) {
if (!dragState.value.active || dragState.value.pointerId !== event.pointerId) {
return
}
const deltaX = event.clientX - dragState.value.startX
const deltaY = event.clientY - dragState.value.startY
if (!dragState.value.moved && Math.hypot(deltaX, deltaY) < DRAG_THRESHOLD) {
return
}
dragState.value.moved = true
setButtonPosition(dragState.value.startLeft + deltaX, dragState.value.startTop + deltaY)
}
function finishDrag(target?: EventTarget | null) {
const pointerId = dragState.value.pointerId
const shouldSuppressClick = dragState.value.moved
dragState.value.pointerId = -1
dragState.value.active = false
dragState.value.moved = false
if (target instanceof HTMLElement && pointerId >= 0 && target.hasPointerCapture?.(pointerId)) {
target.releasePointerCapture(pointerId)
}
if (shouldSuppressClick) {
const nextSide: SnapSide = buttonState.value.left + buttonState.value.width / 2 <= window.innerWidth / 2 ? 'left' : 'right'
snapToSide(nextSide)
}
dragState.value.suppressClick = shouldSuppressClick
}
function handlePointerUp(event: PointerEvent) {
if (dragState.value.pointerId !== event.pointerId) {
return
}
finishDrag(event.currentTarget)
}
function handlePointerCancel(event: PointerEvent) {
if (dragState.value.pointerId !== event.pointerId) {
return
}
finishDrag(event.currentTarget)
}
function handleLostPointerCapture(event: PointerEvent) {
if (dragState.value.active && dragState.value.pointerId === event.pointerId) {
finishDrag(event.currentTarget)
}
}
function handleClick() {
if (dragState.value.suppressClick) {
dragState.value.suppressClick = false
return
}
appSettingsStore.toggleSidebarCollapse()
}
function handleViewportResize() {
if (appSettingsStore.mode !== 'mobile' || !buttonState.value.initialized) {
return
}
syncPositionToViewport()
}
watch(() => appSettingsStore.mode, async (mode) => {
if (mode === 'mobile') {
await initializeButtonPosition()
return
}
dragState.value.pointerId = -1
dragState.value.active = false
dragState.value.moved = false
}, {
immediate: true,
})
onMounted(() => {
window.addEventListener('resize', handleViewportResize, { passive: true })
})
onUnmounted(() => {
window.removeEventListener('resize', handleViewportResize)
})
</script>
<template>
<FaButton
v-if="appSettingsStore.mode === 'mobile' && !appSettingsStore.settings.topbar.toolbar"
ref="buttonRef"
variant="outline"
size="icon"
class="rounded-full size-10 select-none shadow-sm fixed z-1008 touch-none"
:class="{ 'cursor-grabbing': dragState.active, 'cursor-grab': !dragState.active }"
:style="buttonStyle"
@pointerdown="handlePointerDown"
@pointermove="handlePointerMove"
@pointerup="handlePointerUp"
@pointercancel="handlePointerCancel"
@lostpointercapture="handleLostPointerCapture"
@click="handleClick"
>
<FaIcon name="app-toolbar-collapse" class="size-4 rotate-180" />
</FaButton>
</template>
@@ -1,152 +0,0 @@
<script setup lang="ts">
import { useSlots } from '@/slots'
import Logo from '../Logo/index.vue'
defineOptions({
name: 'LayoutHeader',
})
defineProps<{
enable: boolean
}>()
const appSettingsStore = useAppSettingsStore()
const appMenuStore = useAppMenuStore()
const { generateTitle, switchTo } = useAppMenu()
</script>
<template>
<Transition name="header">
<header v-if="enable">
<div class="header-container">
<Component :is="useSlots('header-start')" />
<Logo class="title" />
<Component :is="useSlots('header-after-logo')" />
<FaScrollArea :scrollbar="false" mask horizontal class="menu-container overscroll-contain flex-1 h-full">
<!-- 顶部模式 -->
<div
v-if="appSettingsStore.settings.menu.mode === 'head'" class="menu flex h-full transition-all of-hidden"
>
<template v-for="(item, index) in appMenuStore.allMenus" :key="index">
<div
class="menu-item mx-1 py-2 transition-all relative" :class="{
active: index === appMenuStore.actived,
}"
>
<FaTooltip v-if="item.children && item.children.length !== 0" :disabled="!generateTitle(item.meta?.title)" :text="generateTitle(item.meta?.title)" side="bottom">
<div
class="group menu-item-container text-[var(--g-header-menu-color)] px-3 rounded-lg flex gap-1 h-full w-full cursor-pointer transition-colors items-center justify-between relative hover-(text-[var(--g-header-menu-hover-color)] bg-[var(--g-header-menu-hover-bg)])" :class="{
'text-[var(--g-header-menu-active-color)]! bg-[var(--g-header-menu-active-bg)]!': index === appMenuStore.actived,
}" @click="switchTo(index)"
>
<div class="inline-flex flex-1 gap-1 items-center justify-center">
<FaIcon v-if="item.meta?.icon" :name="item.meta.icon" class="menu-item-container-icon transition-transform group-hover-scale-120" />
<span class="text-sm flex-1 w-full truncate transition-height transition-opacity transition-width empty:hidden">
{{ generateTitle(item.meta?.title) }}
</span>
</div>
</div>
</FaTooltip>
</div>
</template>
</div>
</FaScrollArea>
<Component :is="useSlots('header-after-menu')" />
<div class="flex-center">
<AppAccountButton only-avatar dropdown-side="bottom" class="p-2 size-12" />
</div>
<Component :is="useSlots('header-end')" />
</div>
</header>
</Transition>
</template>
<style scoped>
header {
position: fixed;
top: var(--g-slots-layout-top-height);
right: var(--scrollbar-width, 0);
left: 0;
z-index: 1020;
display: flex;
align-items: center;
width: calc(100% - var(--scrollbar-width, 0px));
height: var(--g-header-height);
margin: 0 auto;
color: var(--g-header-color);
background-color: var(--g-header-bg);
box-shadow: inset 0 -1px 0 0 oklch(var(--border));
transition: width 0.3s, background-color 0.15s, box-shadow 0.15s;
.header-container {
display: flex;
gap: 30px;
align-items: center;
justify-content: space-between;
width: 100%;
max-width: var(--g-header-width);
height: 100%;
padding: 0 12px;
margin: 0 auto;
:deep(a.title) {
position: relative;
flex: 0;
width: inherit;
height: inherit;
padding: 0;
background-color: inherit;
.logo {
width: initial;
max-width: initial;
height: min(70%, 50px);
}
span {
font-size: 20px;
color: var(--g-header-color);
letter-spacing: 1px;
}
}
.menu-container {
.menu {
display: inline-flex;
:deep(.menu-item) {
.menu-item-container {
color: var(--g-header-menu-color);
&:hover {
color: var(--g-header-menu-hover-color);
background-color: var(--g-header-menu-hover-bg);
}
.menu-item-container-icon {
font-size: 20px !important;
}
}
&.active .menu-item-container {
color: var(--g-header-menu-active-color) !important;
background-color: var(--g-header-menu-active-bg) !important;
}
}
}
}
}
}
/* 头部动画 */
.header-enter-active,
.header-leave-active {
transition: transform 0.3s;
}
.header-enter-from,
.header-leave-to {
transform: translateY(calc(var(--g-header-height) * -1));
}
</style>
@@ -1,116 +0,0 @@
<script setup lang="ts">
import { hotkeyBindings } from '@/hotkeys'
import eventBus from '@/utils/eventBus'
defineOptions({
name: 'HotkeysIntro',
})
const appSettingsStore = useAppSettingsStore()
const hotkeyContext = {
settings: appSettingsStore.settings,
}
const helpGroupMeta = {
global: { title: '全局', order: 10 },
nav: { title: '主导航', order: 20 },
tabbar: { title: '标签栏', order: 30 },
} as const
const itemTitleMap: Record<string, string> = {
'global.system': '查看系统信息',
'global.search': '唤起导航搜索',
'nav.next': '激活下一个主导航',
'nav.prev': '激活上一个主导航',
'tabbar.prev': '切换到上一个标签页',
'tabbar.next': '切换到下一个标签页',
'tabbar.close': '关闭当前标签页',
'tabbar.n': '切换到第 n 个标签页',
'tabbar.last': '切换到最后一个标签页',
} as const
const isShow = ref(false)
const helpGroups = computed(() => {
const groups = new Map<string, {
id: string
title: string
order: number
items: {
id: string
title: string
order: number
displayKeys: string[]
}[]
}>()
hotkeyBindings.forEach((binding) => {
const help = binding.help
if (!help) {
return
}
if (help.visible && !help.visible(hotkeyContext)) {
return
}
const meta = helpGroupMeta[help.group as keyof typeof helpGroupMeta]
const group = groups.get(help.group) ?? {
id: help.group,
title: help.groupTitleKey ? itemTitleMap[help.groupTitleKey] ?? help.groupTitleKey : meta?.title ?? help.group,
order: meta?.order ?? 100,
items: [],
}
group.items.push({
id: binding.id,
title: itemTitleMap[help.titleKey] ?? help.titleKey,
order: help.order ?? 0,
displayKeys: appSettingsStore.os === 'mac' && help.displayKeys.mac
? help.displayKeys.mac
: help.displayKeys.default,
})
groups.set(help.group, group)
})
return Array.from(groups.values())
.map(group => ({
...group,
items: [...group.items].sort((a, b) => a.order - b.order),
}))
.sort((a, b) => a.order - b.order)
})
onMounted(() => {
eventBus.on('global-hotkeys-intro-toggle', () => {
isShow.value = !isShow.value
})
})
onUnmounted(() => {
eventBus.off('global-hotkeys-intro-toggle')
})
</script>
<template>
<FaModal v-model="isShow" title="快捷键" :footer="false">
<div class="px-4">
<div class="gap-4 grid sm-grid-cols-2">
<div v-for="group in helpGroups" :key="group.id">
<h2 class="text-lg font-bold m-0">
{{ group.title }}
</h2>
<ul class="text-sm ps-2 pt-2 list-none">
<li v-for="item in group.items" :key="item.id" class="py-1 flex-baseline gap-2">
<FaKbdGroup>
<FaKbd v-for="key in item.displayKeys" :key="key">
{{ key }}
</FaKbd>
</FaKbdGroup>
{{ item.title }}
</li>
</ul>
</div>
</div>
</div>
</FaModal>
</template>
@@ -1,32 +0,0 @@
<script setup lang="ts">
import imgLogo from '@/assets/images/logo.svg'
defineOptions({
name: 'Logo',
})
withDefaults(
defineProps<{
showLogo?: boolean
showTitle?: boolean
}>(),
{
showLogo: true,
showTitle: true,
},
)
const appSettingsStore = useAppSettingsStore()
const title = ref(import.meta.env.VITE_APP_TITLE)
const logo = ref(imgLogo)
const to = computed(() => appSettingsStore.settings.app.home.enable ? appSettingsStore.settings.app.home.fullPath : '')
</script>
<template>
<RouterLink :to class="text-primary px-3 no-underline flex-center gap-2 h-[var(--g-sidebar-logo-height)] w-inherit" :class="{ 'cursor-default': !appSettingsStore.settings.app.home.enable }" :title="title">
<img v-if="showLogo" :src="logo" class="logo h-[30px] w-[30px] object-contain">
<span v-if="showTitle" class="font-bold block truncate">{{ title }}</span>
</RouterLink>
</template>
@@ -1,125 +0,0 @@
<script setup lang="ts">
import { useHotkeyBindings } from '@/hotkeys'
import { useSlots } from '@/slots'
import Logo from '../Logo/index.vue'
defineOptions({
name: 'MainSidebar',
})
defineProps<{
enable: boolean
}>()
const appSettingsStore = useAppSettingsStore()
const appMenuStore = useAppMenuStore()
const { generateTitle, switchTo } = useAppMenu()
useHotkeyBindings({
'menu.next': () => {
switchTo(appMenuStore.actived + 1 < appMenuStore.allMenus.length ? appMenuStore.actived + 1 : 0)
},
'menu.prev': () => {
switchTo(appMenuStore.actived - 1 >= 0 ? appMenuStore.actived - 1 : appMenuStore.allMenus.length - 1)
},
})
</script>
<template>
<Transition name="main-sidebar">
<div v-if="enable" class="main-sidebar-container">
<Component :is="useSlots('main-sidebar-top')" />
<Logo :show-title="false" class="sidebar-logo" />
<Component :is="useSlots('main-sidebar-after-logo')" />
<FaScrollArea :scrollbar="false" mask gradient-color="var(--g-main-sidebar-bg)" class="menu overscroll-contain flex-1">
<!-- 侧边栏模式(含主导航) -->
<div
v-if="appSettingsStore.settings.menu.mode === 'side' || (appSettingsStore.mode === 'mobile' && appSettingsStore.settings.menu.mode !== 'single')" class="py-1 flex flex-col w-full transition-all of-hidden -mt-2"
>
<template v-for="(item, index) in appMenuStore.allMenus" :key="index">
<div
class="menu-item px-2 py-1 transition-all relative" :class="{
active: index === appMenuStore.actived,
}"
>
<FaTooltip v-if="item.children && item.children.length !== 0" :disabled="!generateTitle(item.meta?.title)" :text="generateTitle(item.meta?.title)" side="right">
<div
class="group menu-item-container text-[var(--g-main-sidebar-menu-color)] py-4 rounded-lg flex gap-1 h-full w-full cursor-pointer transition-colors items-center justify-between relative hover-(text-[var(--g-main-sidebar-menu-hover-color)] bg-[var(--g-main-sidebar-menu-hover-bg)]) px-2!" :class="{
'text-[var(--g-main-sidebar-menu-active-color)]! bg-[var(--g-main-sidebar-menu-active-bg)]!': index === appMenuStore.actived,
}" @click="switchTo(index)"
>
<div class="inline-flex flex-1 flex-col gap-1 w-full items-center justify-center">
<FaIcon v-if="item.meta?.icon" :name="item.meta.icon" class="menu-item-container-icon transition-transform group-hover-scale-120" />
<span class="text-sm text-center flex-1 w-full truncate transition-height transition-opacity transition-width empty:hidden">
{{ generateTitle(item.meta?.title) }}
</span>
</div>
</div>
</FaTooltip>
</div>
</template>
</div>
</FaScrollArea>
<Component :is="useSlots('main-sidebar-after-menu')" />
<div class="px-4 py-3 flex-center">
<AppAccountButton only-avatar :button-variant="appSettingsStore.settings.menu.mode === 'side' ? 'secondary' : 'ghost'" class="p-2 size-12" />
</div>
<Component :is="useSlots('main-sidebar-bottom')" />
</div>
</Transition>
</template>
<style scoped>
.main-sidebar-container {
position: relative;
z-index: 10;
display: flex;
flex-direction: column;
width: var(--g-main-sidebar-width);
color: var(--g-main-sidebar-menu-color);
background-color: var(--g-main-sidebar-bg);
box-shadow: 1px 0 0 0 oklch(var(--border));
transition: color 0.15s, background-color 0.15s, box-shadow 0.15s;
.sidebar-logo {
background-color: var(--g-main-sidebar-bg);
transition: background-color 0.15s;
}
.menu {
:deep(.menu-item) {
.menu-item-container {
aspect-ratio: 1 / 1;
padding-block: 8px;
color: var(--g-main-sidebar-menu-color);
&:hover {
color: var(--g-main-sidebar-menu-hover-color);
background-color: var(--g-main-sidebar-menu-hover-bg);
}
.menu-item-container-icon {
font-size: 20px !important;
}
}
&.active .menu-item-container {
color: var(--g-main-sidebar-menu-active-color) !important;
background-color: var(--g-main-sidebar-menu-active-bg) !important;
}
}
}
}
/* 主侧边栏动画 */
.main-sidebar-enter-active,
.main-sidebar-leave-active {
transition: 0.3s;
}
.main-sidebar-enter-from,
.main-sidebar-leave-to {
transform: translateX(calc(var(--g-main-sidebar-width) * -1));
}
</style>
@@ -1,188 +0,0 @@
<script setup lang="ts">
import type { MenuInjection, MenuProps } from './types'
import { cn } from '@/utils'
import Item from './item.vue'
import SubMenu from './sub.vue'
import { rootMenuInjectionKey } from './types'
defineOptions({
name: 'MainMenu',
})
const props = withDefaults(
defineProps<MenuProps>(),
{
accordion: true,
defaultExpandPaths: () => [],
mode: 'vertical',
collapse: false,
},
)
// 用于缓存对象到 ID 的映射
const idMap = new WeakMap<object, string>()
let idCounter = 0
// 获取对象的唯一 ID,如果已存在则返回缓存的 ID,否则生成新的
function getUseId(obj: object): string {
if (!idMap.has(obj)) {
idMap.set(obj, `menu-item-${++idCounter}`)
}
return idMap.get(obj)!
}
const activeIndex = ref<MenuInjection['activeIndex']>(props.value)
const items = ref<MenuInjection['items']>({})
const subMenus = ref<MenuInjection['subMenus']>({})
const expandMenus = ref<MenuInjection['expandMenus']>(props.defaultExpandPaths.slice(0))
const mouseInMenu = ref<MenuInjection['mouseInMenu']>([])
const isMenuPopup = computed<MenuInjection['isMenuPopup']>(() => {
return props.mode === 'horizontal' || (props.mode === 'vertical' && props.collapse)
})
// 解析传入的 menu 数据,并保存到 items 和 subMenus 对象中
function initItems(menu: MenuProps['menu'], parentPaths: string[] = []) {
menu.forEach((item) => {
const index = item.path ?? getUseId(item)
if (item.children?.some(item => item.meta?.menu !== false)) {
const indexPath = [...parentPaths, index]
subMenus.value[index] = {
index,
indexPath,
active: false,
}
initItems(item.children, indexPath)
}
else {
items.value[index] = {
index,
indexPath: parentPaths,
}
}
})
}
const openMenu: MenuInjection['openMenu'] = (index, indexPath) => {
if (expandMenus.value.includes(index)) {
return
}
if (props.accordion) {
expandMenus.value = expandMenus.value.filter(key => indexPath.includes(key))
}
expandMenus.value.push(index)
}
const closeMenu: MenuInjection['closeMenu'] = (index) => {
if (Array.isArray(index)) {
nextTick(() => {
closeMenu(index.at(-1)!)
if (index.length > 1) {
closeMenu(index.slice(0, -1))
}
})
return
}
expandMenus.value = expandMenus.value.filter(item => item !== index)
}
function setSubMenusActive(index: string) {
for (const key in subMenus.value) {
subMenus.value[key].active = false
}
subMenus.value[index]?.indexPath.forEach((idx) => {
subMenus.value[idx].active = true
})
items.value[index]?.indexPath.forEach((idx) => {
subMenus.value[idx].active = true
})
}
const handleMenuItemClick: MenuInjection['handleMenuItemClick'] = (index) => {
if (props.mode === 'horizontal' || props.collapse) {
expandMenus.value = []
}
setSubMenusActive(index)
}
const handleSubMenuClick: MenuInjection['handleSubMenuClick'] = (index, indexPath) => {
if (expandMenus.value.includes(index)) {
closeMenu(index)
}
else {
openMenu(index, indexPath)
}
}
function initMenu() {
const activeItem = activeIndex.value && items.value[activeIndex.value]
setSubMenusActive(activeIndex.value)
if (!activeItem || isMenuPopup.value || props.collapse) {
return
}
// 展开该菜单项的路径上所有子菜单
activeItem.indexPath.forEach((index) => {
const subMenu = subMenus.value[index]
subMenu && openMenu(index, subMenu.indexPath)
})
}
watch(() => props.menu, (val) => {
initItems(val)
initMenu()
}, {
deep: true,
immediate: true,
})
watch(() => props.value, (currentValue) => {
if (!items.value[currentValue]) {
activeIndex.value = ''
}
const item = items.value[currentValue] || (activeIndex.value && items.value[activeIndex.value]) || items.value[props.value]
if (item) {
activeIndex.value = item.index
}
else {
activeIndex.value = currentValue
}
initMenu()
})
watch(() => props.collapse, (value) => {
if (value) {
expandMenus.value = []
}
else {
expandMenus.value = props.defaultExpandPaths.slice(0)
}
initMenu()
})
provide(rootMenuInjectionKey, reactive({
props,
getUseId,
items,
subMenus,
activeIndex,
expandMenus,
mouseInMenu,
isMenuPopup,
openMenu,
closeMenu,
handleMenuItemClick,
handleSubMenuClick,
}))
</script>
<template>
<div
:class="cn('h-full w-full flex flex-col of-hidden', {
'flex-row w-auto': isMenuPopup && props.mode === 'horizontal',
'py-1': props.mode === 'vertical',
})"
>
<template v-for="item in menu" :key="item.path ?? getUseId(item)">
<template v-if="item.meta?.menu !== false">
<SubMenu v-if="item.children?.length" :menu="item" :unique-key="[item.path ?? (item.children.every(item => item.meta?.menu === false) ? item.children[0].path! : getUseId(item))]" />
<Item v-else :item="item" :unique-key="[item.path ?? (item.children?.every(item => item.meta?.menu === false) ? item.children[0].path! : getUseId(item))]" @click="handleMenuItemClick(item.path ?? (item.children?.every(item => item.meta?.menu === false) ? item.children[0].path! : getUseId(item)))" />
</template>
</template>
</div>
</template>
@@ -1,110 +0,0 @@
<script setup lang="ts">
import type { SubMenuItemProps } from './types'
import { cn } from '@/utils'
import { rootMenuInjectionKey } from './types'
defineOptions({
name: 'SubMenuItem',
})
const props = withDefaults(
defineProps<SubMenuItemProps>(),
{
level: 0,
subMenu: false,
expand: false,
},
)
const { generateTitle } = useAppMenu()
const rootMenu = inject(rootMenuInjectionKey)!
const itemRef = ref<HTMLElement>()
const isActived = computed(() => {
return props.subMenu
? rootMenu.subMenus[props.uniqueKey.at(-1)!].active
: rootMenu.activeIndex === props.uniqueKey.at(-1)!
})
const isItemActive = computed(() => {
return isActived.value && (!props.subMenu || rootMenu.isMenuPopup)
})
const icon = computed(() => {
return props.item.meta?.icon
})
defineExpose({
ref: itemRef,
})
</script>
<template>
<div
ref="itemRef" :class="cn('menu-item relative', {
'active': isItemActive,
'py-1 px-2': (rootMenu.isMenuPopup && rootMenu.props.mode === 'vertical') || (rootMenu.isMenuPopup && level !== 0 && rootMenu.props.mode === 'horizontal') || !rootMenu.isMenuPopup,
'px-1 py-2': rootMenu.isMenuPopup && level === 0 && rootMenu.props.mode === 'horizontal',
})"
>
<router-link v-slot="{ href, navigate }" custom :to="uniqueKey.at(-1) ?? ''">
<FaTooltip :disabled="!generateTitle(item.meta?.title) || !rootMenu.isMenuPopup || level !== 0 || subMenu" :text="generateTitle(item.meta?.title)" :side="rootMenu.props.mode === 'vertical' ? 'right' : 'bottom'" class="h-full w-full">
<Component
:is="subMenu ? 'div' : 'a'" v-bind="{
...(!subMenu && {
href: item.meta?.link ? item.meta.link : href,
target: item.meta?.link ? '_blank' : '_self',
class: 'no-underline',
}),
}" :class="cn('group menu-item-container relative h-full w-full min-w-0 flex items-center justify-between gap-1 rounded-lg', {
'px-4 py-3': true,
'cursor-pointer text-[var(--g-sub-sidebar-menu-color)] transition-colors hover-(bg-[var(--g-sub-sidebar-menu-hover-bg)] text-[var(--g-sub-sidebar-menu-hover-color)])': true,
'text-[var(--g-sub-sidebar-menu-active-color)]! bg-[var(--g-sub-sidebar-menu-active-bg)]!': isItemActive,
'px-3': rootMenu.isMenuPopup && level === 0,
'py-3': rootMenu.isMenuPopup && level !== 0,
})" :title="generateTitle(item.meta?.title)" v-on="{
...(!subMenu && {
click: navigate,
}),
}"
>
<div
:class="cn('inline-flex min-w-0 flex-1 items-center justify-start', {
'gap-[12px]': true,
'ps-[calc(var(--indent-level)*20px)]': true,
'flex-col': rootMenu.isMenuPopup && level === 0 && rootMenu.props.mode === 'vertical',
})" :style="{
'--indent-level': !rootMenu.isMenuPopup ? props.level ?? 0 : 0,
}"
>
<FaIcon
v-if="icon" :name="icon" :class="cn('menu-item-container-icon', {
'size-5': true,
'transition-transform group-hover-scale-120': true,
})"
/>
<span
v-if="!(rootMenu.isMenuPopup && level === 0)" :class="cn('block min-w-0 flex-1 truncate text-sm transition-height transition-opacity transition-width', {
'empty:hidden': !generateTitle(item.meta?.title),
})"
>
{{ generateTitle(item.meta?.title) }}
</span>
</div>
<i
v-if="
subMenu
&& (!rootMenu.isMenuPopup || level !== 0) // 非收起模式,非一级的子菜单
" :class="cn('relative ms-1 w-[10px] after:absolute before:absolute after:h-[1.5px] after:w-[6px] before:h-[1.5px] before:w-[6px] after:bg-current before:bg-current after:transition-transform-200 before:transition-transform-200 after:content-empty before:content-empty after:-translate-y-[1px] before:-translate-y-[1px]', {
[expand ? 'before:-rotate-45 before:-translate-x-[2px] after:rotate-45 after:translate-x-[2px]' : 'before:rotate-45 before:-translate-x-[2px] after:-rotate-45 after:translate-x-[2px]']: true,
'opacity-0': rootMenu.isMenuPopup && level === 0,
'-rotate-90 -top-[1.5px]': rootMenu.isMenuPopup && level !== 0,
})"
/>
</component>
</FaTooltip>
</router-link>
</div>
</template>
@@ -1,230 +0,0 @@
<script setup lang="ts">
import type { SubMenuProps } from './types'
import { useTimeoutFn } from '@vueuse/core'
import { cn } from '@/utils'
import Item from './item.vue'
import { rootMenuInjectionKey } from './types'
defineOptions({
name: 'SubMenu',
})
const props = withDefaults(
defineProps<SubMenuProps>(),
{
level: 0,
},
)
const itemRef = useTemplateRef('itemRef')
const subMenuRef = useTemplateRef('subMenuRef')
const rootMenu = inject(rootMenuInjectionKey)!
const index = props.menu.path ?? rootMenu.getUseId(props.menu)
const expand = computed(() => rootMenu.expandMenus.includes(props.uniqueKey.at(-1)!))
const transitionEvent = computed(() => {
if (rootMenu.isMenuPopup) {
return {
enter(el: HTMLElement) {
if (el.offsetHeight > window.innerHeight) {
el.style.height = `${window.innerHeight}px`
}
},
afterEnter: () => {},
beforeLeave: (el: HTMLElement) => {
el.style.maxHeight = `${el.offsetHeight}px`
el.style.overflow = 'hidden'
},
leave: (el: HTMLElement) => {
el.style.maxHeight = '0'
},
afterLeave(el: HTMLElement) {
el.style.maxHeight = ''
el.style.overflow = ''
},
}
}
if (CSS.supports('height', 'calc-size(auto, size)')) {
return {}
}
return {
enter(el: HTMLElement) {
el.dataset.height = el.offsetHeight.toString()
el.style.maxHeight = '0'
el.style.overflow = 'hidden'
void el.offsetHeight // 强制重排,确保浏览器应用初始状态
requestAnimationFrame(() => {
el.style.maxHeight = `${el.dataset.height}px`
})
},
afterEnter(el: HTMLElement) {
el.style.maxHeight = ''
el.style.overflow = ''
},
enterCancelled(el: HTMLElement) {
el.style.maxHeight = ''
el.style.overflow = ''
},
beforeLeave(el: HTMLElement) {
el.style.maxHeight = `${el.offsetHeight}px`
el.style.overflow = 'hidden'
void el.offsetHeight // 强制重排,确保浏览器应用初始状态
},
leave(el: HTMLElement) {
requestAnimationFrame(() => {
el.style.maxHeight = '0'
})
},
afterLeave(el: HTMLElement) {
el.style.maxHeight = ''
el.style.overflow = ''
},
leaveCancelled(el: HTMLElement) {
el.style.maxHeight = ''
el.style.overflow = ''
},
}
})
const transitionClass = computed(() => {
if (rootMenu.isMenuPopup) {
return {
enterActiveClass: 'ease-in-out duration-300',
enterFromClass: 'opacity-0 translate-x-4',
enterToClass: 'opacity-100',
leaveActiveClass: 'ease-in-out duration-300',
leaveFromClass: 'opacity-100',
leaveToClass: 'opacity-0',
}
}
return {
enterActiveClass: 'ease-in-out duration-200',
enterFromClass: cn('opacity-0 translate-y-2', CSS.supports('height', 'calc-size(auto, size)') && 'h-0'),
enterToClass: 'opacity-100 translate-y-0',
leaveActiveClass: 'ease-in-out duration-200',
leaveFromClass: 'opacity-100 translate-y-0',
leaveToClass: cn('opacity-0 translate-y-2', CSS.supports('height', 'calc-size(auto, size)') && 'h-0'),
}
})
const hasChildren = computed(() => props.menu.children?.some((item: any) => item.meta?.menu !== false) ?? false)
function handleClick() {
if (
(rootMenu.isMenuPopup && hasChildren.value)
|| props.menu.meta?.link
) {
return
}
if (hasChildren.value) {
rootMenu.handleSubMenuClick(index, props.uniqueKey)
}
else {
rootMenu.handleMenuItemClick(index)
}
}
let timeout: (() => void) | undefined
function handleMouseenter() {
if (!rootMenu.isMenuPopup) {
return
}
rootMenu.mouseInMenu = props.uniqueKey
timeout?.()
;({ stop: timeout } = useTimeoutFn(() => {
if (hasChildren.value) {
rootMenu.openMenu(index, props.uniqueKey)
nextTick(() => {
requestAnimationFrame(() => {
const el = itemRef.value?.ref
const subMenuEl = subMenuRef.value?.$el
if (!el || !subMenuEl) {
return
}
const rect = el.getBoundingClientRect()
const { top, left, width, height } = rect
let menuTop = 0
let menuLeft = 0
if (rootMenu.props.mode === 'vertical' || props.level !== 0) {
menuTop = top + el.scrollTop - 5 // 4px padding + 1px border
menuLeft = left + width + 4
// 处理边界情况
if (menuTop + subMenuEl.offsetHeight > window.innerHeight) {
menuTop = Math.max(0, window.innerHeight - subMenuEl.offsetHeight)
}
}
else {
menuTop = top + height + 3
menuLeft = left
menuLeft -= 5 // 4px padding + 1px border
// 处理边界情况
if (menuTop + subMenuEl.offsetHeight > window.innerHeight) {
subMenuEl.style.height = `${window.innerHeight - menuTop}px`
}
}
// 处理边界情况
if (menuLeft + subMenuEl.offsetWidth > document.documentElement.clientWidth) {
menuLeft = left - width
}
// 设置样式
Object.assign(subMenuEl.style, {
top: `${menuTop}px`,
insetInlineStart: `${menuLeft}px`,
willChange: 'transform',
transform: 'translateZ(0)',
})
})
})
}
else {
const path = props.menu.children ? rootMenu.subMenus[index].indexPath.at(-1)! : rootMenu.items[index].indexPath.at(-1)!
rootMenu.openMenu(path, rootMenu.subMenus[path].indexPath)
}
}, 300))
}
function handleMouseleave() {
if (!rootMenu.isMenuPopup) {
return
}
rootMenu.mouseInMenu = []
timeout?.()
;({ stop: timeout } = useTimeoutFn(() => {
requestAnimationFrame(() => {
if (rootMenu.mouseInMenu.length === 0) {
rootMenu.closeMenu(props.uniqueKey)
}
else {
if (hasChildren.value) {
!rootMenu.mouseInMenu.includes(props.uniqueKey.at(-1)!) && rootMenu.closeMenu(props.uniqueKey.at(-1)!)
}
}
})
}, 300))
}
</script>
<template>
<Item ref="itemRef" :unique-key="uniqueKey" :item="menu" :level="level" :sub-menu="hasChildren" :expand @click="handleClick" @mouseenter="handleMouseenter" @mouseleave="handleMouseleave" />
<template v-if="hasChildren">
<Teleport to="body" :disabled="!rootMenu.isMenuPopup">
<Transition v-bind="transitionClass" v-on="transitionEvent">
<FaScrollArea
v-if="expand" ref="subMenuRef" :scrollbar="false" :mask="rootMenu.isMenuPopup"
:class="cn('sub-menu static h-[calc-size(auto,size)] rounded-lg', {
'bg-[var(--g-sub-sidebar-bg)]': rootMenu.isMenuPopup,
'border shadow-xl fixed z-3000 w-[200px]': rootMenu.isMenuPopup,
'py-1 overscroll-contain': rootMenu.isMenuPopup,
})"
>
<template v-for="item in menu.children" :key="item.path ?? rootMenu.getUseId(item)">
<SubMenu v-if="item.meta?.menu !== false" :unique-key="[...uniqueKey, item.path ?? rootMenu.getUseId(item)]" :menu="item" :level="level + 1" />
</template>
</FaScrollArea>
</Transition>
</Teleport>
</template>
</template>
@@ -1,47 +0,0 @@
import type { MenuRecordRaw } from '@fantastic-admin/types'
export interface MenuItem {
index: string
indexPath: string[]
active?: boolean
}
export interface MenuProps {
menu: MenuRecordRaw[]
value: string
accordion?: boolean
defaultExpandPaths?: string[]
mode?: 'horizontal' | 'vertical'
collapse?: boolean
}
export interface MenuInjection {
props: MenuProps
getUseId: (obj: object) => string
items: Record<string, MenuItem>
subMenus: Record<string, MenuItem>
activeIndex: MenuProps['value']
expandMenus: string[]
mouseInMenu: string[]
isMenuPopup: boolean
openMenu: (index: string, indexPath: string[]) => void
closeMenu: (index: string | string[]) => void
handleMenuItemClick: (index: string) => void
handleSubMenuClick: (index: string, indexPath: string[]) => void
}
export const rootMenuInjectionKey = Symbol('rootMenu') as InjectionKey<MenuInjection>
export interface SubMenuProps {
uniqueKey: string[]
menu: MenuRecordRaw
level?: number
}
export interface SubMenuItemProps {
uniqueKey: string[]
item: MenuRecordRaw
level?: number
subMenu?: boolean
expand?: boolean
}
@@ -1,169 +0,0 @@
<script setup lang="ts">
import { useSlots } from '@/slots'
import Logo from '../Logo/index.vue'
import Menu from '../Menu/index.vue'
defineOptions({
name: 'SubSidebar',
})
defineProps<{
enable: boolean
}>()
const route = useRoute()
const appSettingsStore = useAppSettingsStore()
const appMenuStore = useAppMenuStore()
const isCollapse = computed(() => appSettingsStore.settings.menu.subMenuCollapse)
const transitionName = ref('')
watch(() => appMenuStore.actived, (val, oldVal) => {
if (appSettingsStore.mode === 'mobile' || appSettingsStore.settings.menu.mode === 'side') {
if (val > oldVal) {
transitionName.value = 'sub-sidebar-y-start'
}
else {
transitionName.value = 'sub-sidebar-y-end'
}
}
else if (appSettingsStore.settings.menu.mode === 'head') {
if (val > oldVal) {
transitionName.value = 'sub-sidebar-x-start'
}
else {
transitionName.value = 'sub-sidebar-x-end'
}
}
})
</script>
<template>
<Transition name="sub-sidebar">
<div
v-if="enable" class="sub-sidebar-container" :class="{
'is-collapse': isCollapse,
}"
>
<Component :is="useSlots('sub-sidebar-top')" />
<Logo
v-if="['side', 'single'].includes(appSettingsStore.settings.menu.mode) || appSettingsStore.mode === 'mobile'" :show-logo="appSettingsStore.settings.menu.mode === 'single'" class="sidebar-logo" :class="{
single: appSettingsStore.settings.menu.mode === 'single',
}"
/>
<Component :is="useSlots('sub-sidebar-after-logo')" />
<FaScrollArea :scrollbar="false" mask class="overscroll-contain flex-1">
<TransitionGroup :name="transitionName">
<template v-for="(mainItem, mainIndex) in appMenuStore.allMenus" :key="mainIndex">
<div v-show="mainIndex === appMenuStore.actived">
<Menu
:menu="mainItem.children" :value="route.meta.activeMenu || route.path" :default-expand-paths="appMenuStore.defaultExpandPaths" :accordion="appSettingsStore.settings.menu.subMenuUniqueExpand" :collapse="isCollapse" class="menu" :class="{
'-mt-2': !(isCollapse || ['head', 'single'].includes(appSettingsStore.settings.menu.mode)),
}"
/>
</div>
</template>
</TransitionGroup>
</FaScrollArea>
<div
v-if="appSettingsStore.mode === 'pc' && appSettingsStore.settings.menu.subMenuCollapseButton" class="px-4 py-3 flex items-center relative" :class="{
'justify-center': isCollapse,
'justify-end': !isCollapse,
}"
>
<FaButton variant="secondary" size="icon-sm" @click="appSettingsStore.toggleSidebarCollapse()">
<FaIcon name="app-toolbar-collapse" class="size-4 transition" :class="{ 'rotate-z--180': appSettingsStore.settings.menu.subMenuCollapse }" />
</FaButton>
</div>
<Component :is="useSlots('sub-sidebar-after-menu')" />
<div v-if="appSettingsStore.settings.menu.mode === 'single'" class="px-4 pb-3 flex-center">
<AppAccountButton :only-avatar="isCollapse" dropdown-align="center" :dropdown-side="isCollapse ? 'right' : 'top'" button-variant="secondary" :class="{ 'w-full': !isCollapse }" />
</div>
<Component :is="useSlots('sub-sidebar-bottom')" />
</div>
</Transition>
</template>
<style scoped>
.sub-sidebar-container {
position: absolute;
inset-inline-start: 0;
top: 0;
bottom: 0;
display: flex;
flex-direction: column;
width: var(--g-sub-sidebar-width);
background-color: var(--g-sub-sidebar-bg);
box-shadow: 1px 0 0 0 oklch(var(--border));
transition: inset-inline-start 0.3s, width 0.3s, background-color 0.15s, box-shadow 0.15s;
&.is-collapse {
width: var(--g-sub-sidebar-collapse-width);
.sidebar-logo {
&:not(.single) {
display: none;
}
:deep(span) {
display: none;
}
}
}
.menu {
width: 100%;
}
}
/* 次侧边栏动画 */
.sub-sidebar-x-start-enter-active,
.sub-sidebar-x-end-enter-active,
.sub-sidebar-y-start-enter-active,
.sub-sidebar-y-end-enter-active {
transition: 0.2s;
}
.sub-sidebar-x-start-enter-from,
.sub-sidebar-x-start-leave-active {
opacity: 0;
transform: translateX(30px);
}
.sub-sidebar-x-end-enter-from,
.sub-sidebar-x-end-leave-active {
opacity: 0;
transform: translateX(-30px);
}
.sub-sidebar-y-start-enter-from,
.sub-sidebar-y-start-leave-active {
opacity: 0;
transform: translateY(30px);
}
.sub-sidebar-y-end-enter-from,
.sub-sidebar-y-end-leave-active {
opacity: 0;
transform: translateY(-30px);
}
.sub-sidebar-x-start-leave-active,
.sub-sidebar-x-end-leave-active,
.sub-sidebar-y-start-leave-active,
.sub-sidebar-y-end-leave-active {
position: absolute;
}
/* 次侧边栏动画 */
.sub-sidebar-enter-active,
.sub-sidebar-leave-active {
transition: 0.3s;
}
.sub-sidebar-enter-from,
.sub-sidebar-leave-to {
transform: translateX(calc(var(--g-sub-sidebar-width) * -1));
}
</style>
@@ -1,71 +0,0 @@
<script setup lang="ts">
import { compile } from 'path-to-regexp'
import Breadcrumb from '../../../Breadcrumb/index.vue'
import BreadcrumbItem from '../../../Breadcrumb/item.vue'
defineOptions({
name: 'ToolbarBreadcrumb',
})
const route = useRoute()
const appSettingsStore = useAppSettingsStore()
const { generateTitle } = useAppMenu()
interface BreadcrumbRecord {
path: string
title?: string | (() => string)
}
let breadcrumbListBackup: BreadcrumbRecord[] = []
const breadcrumbList = computed<BreadcrumbRecord[]>(() => {
if (route.name === 'reload') {
return breadcrumbListBackup
}
const list: BreadcrumbRecord[] = []
if (appSettingsStore.settings.app.home.enable) {
list.push({
path: appSettingsStore.settings.app.home.fullPath,
title: appSettingsStore.settings.app.home.title,
})
}
route.matched.forEach((item) => {
if (item.meta?.breadcrumb !== false) {
list.push({
path: item.path,
title: item.meta?.title,
})
}
})
breadcrumbListBackup = list.filter(item => generateTitle(item.title))
return breadcrumbListBackup
})
function pathCompile(path: string) {
const toPath = compile(path)
return toPath(route.params)
}
</script>
<template>
<Breadcrumb v-if="appSettingsStore.mode === 'pc'" class="breadcrumb px-2 whitespace-nowrap">
<TransitionGroup name="breadcrumb">
<BreadcrumbItem v-for="(item, index) in breadcrumbList" :key="`${index}_${item.path}_${item.title}`" :to="index < breadcrumbList.length - 1 && item.path !== '' ? pathCompile(item.path) : ''">
{{ generateTitle(item.title) }}
</BreadcrumbItem>
</TransitionGroup>
</Breadcrumb>
</template>
<style scoped>
/* 面包屑动画 */
.breadcrumb-enter-active {
transition: transform 0.3s, opacity 0.3s;
}
.breadcrumb-enter-from {
opacity: 0;
transform: translateX(30px) skewX(-50deg);
}
</style>
@@ -1,58 +0,0 @@
<script setup lang="ts">
defineOptions({
name: 'ToolbarColorScheme',
})
const appSettingsStore = useAppSettingsStore()
function toggleColorScheme(event: MouseEvent) {
if (!document.startViewTransition || window.matchMedia('(prefers-reduced-motion: reduce)').matches) {
appSettingsStore.currentColorScheme && appSettingsStore.setColorScheme(appSettingsStore.currentColorScheme === 'dark' ? 'light' : 'dark')
return
}
const target = event.target as HTMLElement
const { left, top, width, height } = target.getBoundingClientRect()
const x = left + width / 2
const y = top + height / 2
const endRadius = Math.hypot(
Math.max(x, innerWidth - x),
Math.max(y, innerHeight - y),
)
const ratioX = (100 * x) / innerWidth
const ratioY = (100 * y) / innerHeight
const referR = Math.hypot(innerWidth, innerHeight) / Math.SQRT2
const ratioR = (100 * endRadius) / referR
const transition = document.startViewTransition(async () => {
appSettingsStore.currentColorScheme && appSettingsStore.setColorScheme(appSettingsStore.currentColorScheme === 'dark' ? 'light' : 'dark')
await nextTick()
})
transition.ready.then(() => {
const clipPath = [
`circle(0% at ${ratioX}% ${ratioY}%)`,
`circle(${ratioR}% at ${ratioX}% ${ratioY}%)`,
]
document.documentElement.animate(
{
clipPath: appSettingsStore.currentColorScheme === 'light' ? clipPath : clipPath.toReversed(),
},
{
duration: 500,
easing: 'ease-in-out',
fill: 'both',
pseudoElement: appSettingsStore.currentColorScheme === 'light' ? '::view-transition-new(root)' : '::view-transition-old(root)',
},
)
})
}
</script>
<template>
<FaButton variant="ghost" size="icon-sm" @click="toggleColorScheme">
<FaIcon
:name="{
light: 'i-ri:sun-line',
dark: 'i-ri:moon-line',
}[appSettingsStore.currentColorScheme!]" class="size-4"
/>
</FaButton>
</template>
@@ -1,35 +0,0 @@
<script setup lang="ts">
import { useHotkeyBindings } from '@/hotkeys'
import Search from './search.vue'
defineOptions({
name: 'ToolbarMenuSearch',
})
const appSettingsStore = useAppSettingsStore()
const isShow = ref(false)
const useMobileStyle = computed(() => {
return appSettingsStore.mode !== 'pc' || !appSettingsStore.settings.toolbar.menuSearch.hotkeys
})
useHotkeyBindings({
'menuSearch.open': () => {
isShow.value = true
},
})
</script>
<template>
<FaButton :variant="useMobileStyle ? 'ghost' : 'outline'" :size="useMobileStyle ? 'icon-sm' : undefined" :class="{ 'mx-2 px-3 h-9': !useMobileStyle }" @click="isShow = true">
<FaIcon name="i-ri:search-line" class="size-4" />
<template v-if="!useMobileStyle">
<FaKbdGroup v-if="appSettingsStore.settings.toolbar.menuSearch.hotkeys" class="-me-1">
<FaKbd>{{ appSettingsStore.os === 'mac' ? '⌘' : 'Ctrl' }}</FaKbd>
<FaKbd>K</FaKbd>
</FaKbdGroup>
</template>
</FaButton>
<Search v-model="isShow" />
</template>
@@ -1,256 +0,0 @@
<script setup lang="ts">
import type { MenuRecordRaw } from '@fantastic-admin/types'
import { match } from 'pinyin-pro'
import { useHotkeyBindings } from '@/hotkeys'
import Breadcrumb from '@/layouts/components/Breadcrumb/index.vue'
import BreadcrumbItem from '@/layouts/components/Breadcrumb/item.vue'
import { resolveRoutePath } from '@/utils'
defineOptions({
name: 'ToolbarMenuSearchModal',
})
const isShow = defineModel<boolean>({
default: false,
})
const router = useRouter()
const appSettingsStore = useAppSettingsStore()
const appRouteStore = useAppRouteStore()
const appMenuStore = useAppMenuStore()
const { generateTitle } = useAppMenu()
interface listTypes {
path: string
icon?: string
title?: string | (() => string)
link?: string
}
const searchInput = ref('')
const sourceList = ref<listTypes[]>([])
const actived = ref(0)
const searchResultRef = useTemplateRef('searchResultRef')
const searchResultItemRef = useTemplateRef<HTMLElement[]>('searchResultItemRef')
const resultList = computed(() => {
let result = []
result = sourceList.value.filter((item) => {
let flag = false
if (searchInput.value !== '') {
if (item.path.includes(searchInput.value)) {
flag = true
}
if (
generateTitle(item.title).toString().includes(searchInput.value)
|| (match(generateTitle(item.title).toString(), searchInput.value, { continuous: true })?.length ?? 0) > 0
) {
flag = true
}
if (appRouteStore.getRouteMatchedByPath(item.path).some((b) => {
return generateTitle(b.meta?.title).toString().includes(searchInput.value)
|| (match(generateTitle(b.meta?.title).toString(), searchInput.value, { continuous: true })?.length ?? 0) > 0
})) { flag = true }
}
return flag
})
return result
})
useHotkeyBindings({
'menuSearch.moveUp': () => {
keyUp()
},
'menuSearch.moveDown': () => {
keyDown()
},
'menuSearch.confirm': () => {
keyEnter()
},
'menuSearch.close': () => {
isShow.value = false
},
}, () => isShow.value)
watch(() => isShow.value, (val) => {
if (val) {
searchInput.value = ''
actived.value = 0
}
})
watch(() => resultList.value, () => {
actived.value = 0
handleScroll()
})
watch(() => actived.value, () => {
handleScroll()
})
onMounted(() => {
initSourceList()
})
function initSourceList() {
sourceList.value = []
appMenuStore.allMenus.forEach((item) => {
getSourceList(item.children)
})
}
function hasChildren(item: MenuRecordRaw) {
let flag = true
if (item.children?.every(i => i.meta?.menu === false)) {
flag = false
}
return flag
}
function getSourceList(arr: MenuRecordRaw[], basePath?: string, icon?: string) {
arr.forEach((item) => {
if (item.meta?.menu !== false) {
if (item.children && hasChildren(item)) {
getSourceList(
item.children,
resolveRoutePath(basePath, item.path),
item.meta?.icon ?? icon,
)
}
else {
sourceList.value.push({
path: resolveRoutePath(basePath, item.path),
icon: item.meta?.icon ?? icon,
title: item.meta?.title,
link: item.meta?.link,
})
}
}
})
}
function keyUp() {
if (resultList.value.length) {
actived.value -= 1
if (actived.value < 0) {
actived.value = resultList.value.length - 1
}
}
}
function keyDown() {
if (resultList.value.length) {
actived.value += 1
if (actived.value > resultList.value.length - 1) {
actived.value = 0
}
}
}
function keyEnter() {
searchResultItemRef.value?.find(item => Number.parseInt(item.dataset.index!) === actived.value)?.click()
}
function handleScroll() {
if (searchResultRef.value?.ref?.el?.viewportElement) {
const contentDom = searchResultRef.value.ref.el.viewportElement
let scrollTo = 0
if (resultList.value.length > 0) {
scrollTo = contentDom.scrollTop
const activedOffsetTop = searchResultItemRef.value?.find(item => Number.parseInt(item.dataset.index!) === actived.value)?.offsetTop ?? 0
const activedClientHeight = searchResultItemRef.value?.find(item => Number.parseInt(item.dataset.index!) === actived.value)?.clientHeight ?? 0
const searchScrollTop = contentDom.scrollTop
const searchClientHeight = contentDom.clientHeight
if (activedOffsetTop + activedClientHeight > searchScrollTop + searchClientHeight) {
scrollTo = activedOffsetTop + activedClientHeight - searchClientHeight
}
else if (activedOffsetTop <= searchScrollTop) {
scrollTo = activedOffsetTop - 16
}
}
contentDom.scrollTo({
top: scrollTo,
})
}
}
function pageJump(path: listTypes['path'], link: listTypes['link']) {
if (link) {
window.open(link, '_blank')
}
else {
router.push(path)
}
isShow.value = false
}
</script>
<template>
<FaModal v-model="isShow" :footer="appSettingsStore.mode === 'pc'" :closable="false" open-auto-focus border class="w-full lg-max-w-2xl" content-class="flex flex-col p-0 min-h-auto" header-class="p-0" footer-class="p-0">
<template #header>
<div class="flex flex-shrink-0 h-12 items-center">
<div class="flex-center h-full w-14">
<FaIcon name="i-ri:search-line" class="text-foreground/30 size-4" />
</div>
<input v-model="searchInput" placeholder="支持标题、拼音(首字母)、URL模糊查询" class="text-base text-foreground border-0 rounded-md bg-transparent h-full w-full focus-outline-none placeholder-foreground/30" @keydown.esc.prevent="isShow = false" @keydown.up.prevent="keyUp" @keydown.down.prevent="keyDown" @keydown.enter.prevent="keyEnter">
<div v-if="appSettingsStore.mode === 'mobile'" class="border-s flex-center h-full w-14">
<FaIcon name="i-carbon:close" class="size-4" @click="isShow = false" />
</div>
</div>
</template>
<template #footer>
<div class="px-4 py-3 flex w-full justify-between">
<div class="flex gap-8">
<div class="text-xs inline-flex gap-1 items-center">
<FaKbd>⏎</FaKbd>
<span>访问</span>
</div>
<div class="text-xs inline-flex gap-1 items-center">
<FaKbd>
<FaIcon name="i-ant-design:caret-up-filled" />
</FaKbd>
<FaKbd>
<FaIcon name="i-ant-design:caret-down-filled" />
</FaKbd>
<span>切换</span>
</div>
</div>
<div v-if="appSettingsStore.settings.toolbar.menuSearch.hotkeys" class="text-xs inline-flex gap-1 items-center">
<FaKbd>Esc</FaKbd>
<span>退出</span>
</div>
</div>
</template>
<FaScrollArea ref="searchResultRef">
<template v-if="resultList.length > 0">
<div v-for="(item, index) in resultList" ref="searchResultItemRef" :key="item.path" class="p-4" :data-index="index" @click="pageJump(item.path, item.link)" @mouseover="actived = index">
<a class="border rounded-lg flex cursor-pointer items-center" :class="{ '-mt-4': index !== 0, 'bg-accent border-primary shadow-[0_0_0_1px_oklch(var(--primary))]': index === actived, 'op-50': index !== actived }">
<div class="flex-center basis-16 -me-4">
<FaIcon v-if="item.icon" :name="item.icon" class="size-5 transition" :class="{ 'scale-120 text-primary': index === actived }" />
</div>
<div class="px-4 py-3 flex flex-1 flex-col gap-1 truncate">
<div class="text-base font-bold text-start truncate">{{ generateTitle(item.title) }}</div>
<Breadcrumb v-if="appRouteStore.getRouteMatchedByPath(item.path).length" class="truncate">
<BreadcrumbItem v-for="(bc, bcIndex) in appRouteStore.getRouteMatchedByPath(item.path)" :key="bcIndex" class="text-xs">
{{ generateTitle(bc.meta?.title) }}
</BreadcrumbItem>
</Breadcrumb>
</div>
</a>
</div>
</template>
<template v-else-if="searchInput === ''">
<div class="text-secondary-foreground/50 py-6 flex-col-center h-full">
<FaIcon name="i-tabler:mood-smile" class="size-10" />
<p class="text-base m-2">
输入你要搜索的导航
</p>
</div>
</template>
<template v-else>
<div class="text-secondary-foreground/50 py-6 flex-col-center h-full">
<FaIcon name="i-tabler:mood-empty" class="size-10" />
<p class="text-base m-2">
没有找到你想要的
</p>
</div>
</template>
</FaScrollArea>
</FaModal>
</template>
@@ -1,53 +0,0 @@
<script setup lang="ts">
defineOptions({
name: 'ToolbarPageReload',
})
const appSettingsStore = useAppSettingsStore()
const mainPage = useAppPage()
const isAnimating = ref(false)
function handleClick(event: MouseEvent) {
if (event.ctrlKey && !event.altKey && !event.metaKey && !event.shiftKey) {
location.reload()
return
}
if (!event.ctrlKey && !event.altKey && !event.metaKey && !event.shiftKey) {
isAnimating.value = true
mainPage.reload()
}
}
</script>
<template>
<FaTooltip side="bottom" :disabled="appSettingsStore.os === 'mac'">
<template #content>
<div class="flex-col-center gap-2">
<p class="flex-center gap-1">
按住 <FaKbd>Ctrl</FaKbd> 键并点击
</p>
<p>可切换为浏览器原生刷新</p>
</div>
</template>
<FaButton variant="ghost" size="icon-sm" @click="handleClick" @animationend="isAnimating = false">
<FaIcon name="i-iconoir:refresh-double" class="size-4" :class="{ animation: isAnimating }" />
</FaButton>
</FaTooltip>
</template>
<style scoped>
.animation {
animation: animation 1s;
}
@keyframes animation {
0% {
transform: rotate(0deg);
}
100% {
transform: rotate(360deg);
}
}
</style>
@@ -1,15 +0,0 @@
<script setup lang="ts">
import { useSlots } from '@/slots'
import Tools from './tools.vue'
defineOptions({
name: 'ToolbarRightSide',
})
</script>
<template>
<div class="flex items-center">
<Tools mode="right-side" />
<Component :is="useSlots('toolbar-end')" />
</div>
</template>
@@ -1,25 +0,0 @@
<script setup lang="ts">
import EndSide from './endSide.vue'
import StartSide from './startSide.vue'
defineOptions({
name: 'Toolbar',
})
</script>
<template>
<div class="bg-[var(--g-toolbar-bg)] flex h-[var(--g-toolbar-height)] items-center justify-between">
<div class="start-side pe-16 ps-2 flex h-full items-center of-hidden">
<StartSide />
</div>
<div class="px-2 flex flex-shrink-0 h-full items-center justify-end">
<EndSide />
</div>
</div>
</template>
<style scoped>
.start-side {
mask-image: linear-gradient(to right, #000 0%, #000 calc(100% - 50px), transparent);
}
</style>
@@ -1,20 +0,0 @@
<script setup lang="ts">
import { useSlots } from '@/slots'
import Tools from './tools.vue'
defineOptions({
name: 'ToolbarLeftSide',
})
const appSettingsStore = useAppSettingsStore()
</script>
<template>
<div class="flex items-center">
<FaButton v-if="appSettingsStore.mode === 'mobile'" variant="ghost" size="icon" class="size-9" @click="appSettingsStore.toggleSidebarCollapse()">
<FaIcon name="app-toolbar-collapse" class="size-4" />
</FaButton>
<Component :is="useSlots('toolbar-start')" />
<Tools mode="left-side" />
</div>
</template>
@@ -1,39 +0,0 @@
<script setup lang="ts">
import type { ToolbarSettings } from '@fantastic-admin/settings'
import { pascalCase } from 'scule'
defineOptions({
name: 'ToolbarTools',
})
const props = defineProps<{
mode: 'left-side' | 'right-side'
}>()
const modules = import.meta.glob('./*/index.vue', { import: 'default', eager: true })
const appSettingsStore = useAppSettingsStore()
const toolbarTools = {
'left-side': ['breadcrumb'],
'right-side': ['menuSearch', 'fullscreen', 'pageReload', 'colorScheme'],
} satisfies Record<typeof props.mode, (keyof ToolbarSettings)[]>
const tools = computed(() => toolbarTools[props.mode])
function checkVisible(item: boolean | { enable: boolean }) {
if (typeof item === 'boolean') {
return item
}
else if (typeof item === 'object' && item !== null) {
return item.enable ?? false
}
return false
}
</script>
<template>
<template v-for="item in tools" :key="item">
<Component :is="modules[`./${pascalCase(item)}/index.vue`]" v-if="checkVisible(appSettingsStore.settings.toolbar[item])" />
</template>
</template>
@@ -1,56 +0,0 @@
<script setup lang="ts">
import { useElementSize, useScroll } from '@vueuse/core'
import eventBus from '@/utils/eventBus'
import Tabbar from './Tabbar/index.vue'
import Toolbar from './Toolbar/index.vue'
defineOptions({
name: 'Topbar',
})
defineProps<{
enable: boolean
enableTabbar: boolean
enableToolbar: boolean
}>()
const appSettingsStore = useAppSettingsStore()
const { height: topbarHeight } = useElementSize(useTemplateRef('topbarRef'))
const { y } = useScroll(window)
const scrollOnHide = ref(false)
watch(y, (val, oldVal) => {
scrollOnHide.value = appSettingsStore.settings.topbar.mode === 'sticky' && val > (oldVal ?? 0) && val > topbarHeight.value
})
watch(scrollOnHide, (val) => {
eventBus.emit('topbar-scroll-visible-or-hidden', val)
}, {
immediate: true,
})
</script>
<template>
<Transition name="topbar">
<div
v-if="enable" ref="topbarRef" class="flex flex-col w-full shadow-[0_1px_0_0_oklch(var(--border))] transition-transform-300"
>
<Tabbar v-if="enableTabbar" class="z-2" />
<Toolbar v-if="enableToolbar" class="z-1" />
</div>
</Transition>
</template>
<style scoped>
/* 顶栏动画 */
.topbar-enter-active,
.topbar-leave-active {
transition: transform 0.3s;
}
.topbar-enter-from,
.topbar-leave-to {
transform: translateY(calc(var(--g-topbar-height) * -1));
}
</style>

Some files were not shown because too many files have changed in this diff Show More