@kevairy/template 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +14 -0
- package/package.json +37 -0
- package/template/.env +22 -0
- package/template/.env.development +13 -0
- package/template/.env.production +10 -0
- package/template/.prettierignore +3 -0
- package/template/.prettierrc +20 -0
- package/template/.stylelintignore +9 -0
- package/template/.stylelintrc.cjs +84 -0
- package/template/LICENSE +21 -0
- package/template/README.md +22 -0
- package/template/_gitignore +19 -0
- package/template/eslint-auto-import.json +324 -0
- package/template/eslint.config.mjs +83 -0
- package/template/index.html +25 -0
- package/template/package.json +79 -0
- package/template/playwright.config.ts +25 -0
- package/template/public/favicon.ico +0 -0
- package/template/src/App.vue +39 -0
- package/template/src/adapters/auth/index.ts +9 -0
- package/template/src/adapters/auth/mock.ts +10 -0
- package/template/src/adapters/auth/types.ts +11 -0
- package/template/src/adapters/navigation/index.ts +13 -0
- package/template/src/adapters/navigation/types.ts +6 -0
- package/template/src/api/auth.ts +23 -0
- package/template/src/assets/images/avatar/avatar.webp +0 -0
- package/template/src/assets/images/avatar/avatar1.webp +0 -0
- package/template/src/assets/images/avatar/avatar10.webp +0 -0
- package/template/src/assets/images/avatar/avatar2.webp +0 -0
- package/template/src/assets/images/avatar/avatar3.webp +0 -0
- package/template/src/assets/images/avatar/avatar4.webp +0 -0
- package/template/src/assets/images/avatar/avatar5.webp +0 -0
- package/template/src/assets/images/avatar/avatar6.webp +0 -0
- package/template/src/assets/images/avatar/avatar7.webp +0 -0
- package/template/src/assets/images/avatar/avatar8.webp +0 -0
- package/template/src/assets/images/avatar/avatar9.webp +0 -0
- package/template/src/assets/images/ceremony/hb.png +0 -0
- package/template/src/assets/images/ceremony/sd.png +0 -0
- package/template/src/assets/images/ceremony/xc.png +0 -0
- package/template/src/assets/images/ceremony/yd.png +0 -0
- package/template/src/assets/images/common/logo.webp +0 -0
- package/template/src/assets/images/draw/draw1.png +0 -0
- package/template/src/assets/images/favicon.ico +0 -0
- package/template/src/assets/images/lock/bg_dark.webp +0 -0
- package/template/src/assets/images/lock/bg_light.webp +0 -0
- package/template/src/assets/images/login/kylin-hero-source.png +0 -0
- package/template/src/assets/images/login/lf_icon2.webp +0 -0
- package/template/src/assets/images/settings/menu_layouts/dual_column.png +0 -0
- package/template/src/assets/images/settings/menu_layouts/horizontal.png +0 -0
- package/template/src/assets/images/settings/menu_layouts/mixed.png +0 -0
- package/template/src/assets/images/settings/menu_layouts/vertical.png +0 -0
- package/template/src/assets/images/settings/menu_styles/dark.png +0 -0
- package/template/src/assets/images/settings/menu_styles/design.png +0 -0
- package/template/src/assets/images/settings/menu_styles/light.png +0 -0
- package/template/src/assets/images/settings/theme_styles/dark.png +0 -0
- package/template/src/assets/images/settings/theme_styles/light.png +0 -0
- package/template/src/assets/images/settings/theme_styles/system.png +0 -0
- package/template/src/assets/images/svg/403.svg +1 -0
- package/template/src/assets/images/svg/404.svg +1 -0
- package/template/src/assets/images/svg/500.svg +5 -0
- package/template/src/assets/images/svg/login_icon.svg +1 -0
- package/template/src/assets/images/user/avatar.webp +0 -0
- package/template/src/assets/images/user/bg.webp +0 -0
- package/template/src/assets/styles/core/app.scss +227 -0
- package/template/src/assets/styles/core/dark.scss +93 -0
- package/template/src/assets/styles/core/el-dark.scss +2 -0
- package/template/src/assets/styles/core/el-light.scss +34 -0
- package/template/src/assets/styles/core/el-ui.scss +519 -0
- package/template/src/assets/styles/core/md.scss +1036 -0
- package/template/src/assets/styles/core/mixin.scss +157 -0
- package/template/src/assets/styles/core/reset.scss +41 -0
- package/template/src/assets/styles/core/router-transition.scss +104 -0
- package/template/src/assets/styles/core/tailwind.css +219 -0
- package/template/src/assets/styles/core/theme-animation.scss +63 -0
- package/template/src/assets/styles/core/theme-change.scss +11 -0
- package/template/src/assets/styles/custom/one-dark-pro.scss +98 -0
- package/template/src/assets/styles/index.scss +23 -0
- package/template/src/assets/svg/loading.ts +32 -0
- package/template/src/bootstrap/initializeApp.ts +30 -0
- package/template/src/components/core/banners/art-basic-banner/index.vue +343 -0
- package/template/src/components/core/banners/art-card-banner/index.vue +114 -0
- package/template/src/components/core/base/art-back-to-top/index.vue +40 -0
- package/template/src/components/core/base/art-logo/index.vue +34 -0
- package/template/src/components/core/base/art-svg-icon/index.vue +24 -0
- package/template/src/components/core/cards/art-bar-chart-card/index.vue +103 -0
- package/template/src/components/core/cards/art-data-list-card/index.vue +74 -0
- package/template/src/components/core/cards/art-donut-chart-card/index.vue +124 -0
- package/template/src/components/core/cards/art-image-card/index.vue +89 -0
- package/template/src/components/core/cards/art-line-chart-card/index.vue +126 -0
- package/template/src/components/core/cards/art-progress-card/index.vue +86 -0
- package/template/src/components/core/cards/art-stats-card/index.vue +67 -0
- package/template/src/components/core/cards/art-timeline-list-card/index.vue +69 -0
- package/template/src/components/core/charts/art-bar-chart/index.vue +203 -0
- package/template/src/components/core/charts/art-dual-bar-compare-chart/index.vue +195 -0
- package/template/src/components/core/charts/art-h-bar-chart/index.vue +208 -0
- package/template/src/components/core/charts/art-k-line-chart/index.vue +152 -0
- package/template/src/components/core/charts/art-line-chart/index.vue +371 -0
- package/template/src/components/core/charts/art-radar-chart/index.vue +105 -0
- package/template/src/components/core/charts/art-ring-chart/index.vue +133 -0
- package/template/src/components/core/charts/art-scatter-chart/index.vue +115 -0
- package/template/src/components/core/feedback/art-page-loading/index.vue +281 -0
- package/template/src/components/core/forms/art-button-more/index.vue +71 -0
- package/template/src/components/core/forms/art-button-table/index.vue +59 -0
- package/template/src/components/core/forms/art-drag-verify/index.vue +430 -0
- package/template/src/components/core/forms/art-excel-export/index.vue +390 -0
- package/template/src/components/core/forms/art-excel-import/index.vue +62 -0
- package/template/src/components/core/forms/art-form/index.vue +507 -0
- package/template/src/components/core/forms/art-wang-editor/index.vue +261 -0
- package/template/src/components/core/forms/art-wang-editor/style.scss +273 -0
- package/template/src/components/core/layouts/art-breadcrumb/index.vue +142 -0
- package/template/src/components/core/layouts/art-chat-window/index.vue +262 -0
- package/template/src/components/core/layouts/art-fast-enter/index.vue +113 -0
- package/template/src/components/core/layouts/art-fireworks-effect/index.vue +633 -0
- package/template/src/components/core/layouts/art-global-component/index.vue +14 -0
- package/template/src/components/core/layouts/art-global-search/index.vue +431 -0
- package/template/src/components/core/layouts/art-header-bar/index.vue +485 -0
- package/template/src/components/core/layouts/art-header-bar/widget/ArtUserMenu.vue +118 -0
- package/template/src/components/core/layouts/art-menus/art-horizontal-menu/index.vue +110 -0
- package/template/src/components/core/layouts/art-menus/art-horizontal-menu/widget/HorizontalSubmenu.vue +106 -0
- package/template/src/components/core/layouts/art-menus/art-mixed-menu/index.vue +279 -0
- package/template/src/components/core/layouts/art-menus/art-sidebar-menu/index.vue +354 -0
- package/template/src/components/core/layouts/art-menus/art-sidebar-menu/style.scss +251 -0
- package/template/src/components/core/layouts/art-menus/art-sidebar-menu/theme.scss +258 -0
- package/template/src/components/core/layouts/art-menus/art-sidebar-menu/widget/SidebarSubmenu.vue +190 -0
- package/template/src/components/core/layouts/art-notification/index.vue +456 -0
- package/template/src/components/core/layouts/art-page-content/index.vue +137 -0
- package/template/src/components/core/layouts/art-settings-panel/composables/useSettingsConfig.ts +248 -0
- package/template/src/components/core/layouts/art-settings-panel/composables/useSettingsHandlers.ts +167 -0
- package/template/src/components/core/layouts/art-settings-panel/composables/useSettingsPanel.ts +233 -0
- package/template/src/components/core/layouts/art-settings-panel/composables/useSettingsState.ts +37 -0
- package/template/src/components/core/layouts/art-settings-panel/index.vue +72 -0
- package/template/src/components/core/layouts/art-settings-panel/style.scss +92 -0
- package/template/src/components/core/layouts/art-settings-panel/widget/BasicSettings.vue +77 -0
- package/template/src/components/core/layouts/art-settings-panel/widget/BoxStyleSettings.vue +38 -0
- package/template/src/components/core/layouts/art-settings-panel/widget/ColorSettings.vue +35 -0
- package/template/src/components/core/layouts/art-settings-panel/widget/ContainerSettings.vue +33 -0
- package/template/src/components/core/layouts/art-settings-panel/widget/MenuLayoutSettings.vue +31 -0
- package/template/src/components/core/layouts/art-settings-panel/widget/MenuStyleSettings.vue +44 -0
- package/template/src/components/core/layouts/art-settings-panel/widget/SectionTitle.vue +17 -0
- package/template/src/components/core/layouts/art-settings-panel/widget/SettingActions.vue +236 -0
- package/template/src/components/core/layouts/art-settings-panel/widget/SettingDrawer.vue +51 -0
- package/template/src/components/core/layouts/art-settings-panel/widget/SettingHeader.vue +18 -0
- package/template/src/components/core/layouts/art-settings-panel/widget/SettingItem.vue +101 -0
- package/template/src/components/core/layouts/art-settings-panel/widget/ThemeSettings.vue +28 -0
- package/template/src/components/core/layouts/art-work-tab/index.vue +584 -0
- package/template/src/components/core/media/art-cutter-img/index.vue +350 -0
- package/template/src/components/core/media/art-video-player/index.vue +111 -0
- package/template/src/components/core/others/art-menu-right/index.vue +415 -0
- package/template/src/components/core/others/art-watermark/index.vue +64 -0
- package/template/src/components/core/text-effect/art-count-to/index.vue +310 -0
- package/template/src/components/core/text-effect/art-festival-text-scroll/index.vue +32 -0
- package/template/src/components/core/text-effect/art-text-scroll/index.vue +285 -0
- package/template/src/components/core/theme/theme-svg/index.vue +100 -0
- package/template/src/components/core/views/exception/ArtException.vue +55 -0
- package/template/src/components/core/views/login/AuthTopBar.vue +149 -0
- package/template/src/components/core/views/login/LoginLeftView.vue +602 -0
- package/template/src/components/core/views/result/ArtResultPage.vue +43 -0
- package/template/src/components/core/widget/art-icon-button/index.vue +23 -0
- package/template/src/config/assets/images.ts +61 -0
- package/template/src/config/index.ts +170 -0
- package/template/src/config/modules/component.ts +98 -0
- package/template/src/config/modules/fastEnter.ts +16 -0
- package/template/src/config/modules/festival.ts +51 -0
- package/template/src/config/modules/headerBar.ts +64 -0
- package/template/src/config/setting.ts +109 -0
- package/template/src/directives/core/auth.ts +66 -0
- package/template/src/directives/core/highlight-loader.ts +37 -0
- package/template/src/directives/core/highlight.ts +253 -0
- package/template/src/directives/core/ripple.ts +116 -0
- package/template/src/directives/core/roles.ts +87 -0
- package/template/src/directives/index.ts +14 -0
- package/template/src/enums/appEnum.ts +81 -0
- package/template/src/enums/formEnum.ts +17 -0
- package/template/src/env.d.ts +32 -0
- package/template/src/hooks/core/useAppMode.ts +45 -0
- package/template/src/hooks/core/useAuth.ts +74 -0
- package/template/src/hooks/core/useCeremony.ts +184 -0
- package/template/src/hooks/core/useChart.ts +745 -0
- package/template/src/hooks/core/useCommon.ts +87 -0
- package/template/src/hooks/core/useFastEnter.ts +55 -0
- package/template/src/hooks/core/useHeaderBar.ts +201 -0
- package/template/src/hooks/core/useLayoutHeight.ts +148 -0
- package/template/src/hooks/core/useTableColumns.ts +313 -0
- package/template/src/hooks/core/useTheme.ts +174 -0
- package/template/src/hooks/index.ts +29 -0
- package/template/src/locales/index.ts +123 -0
- package/template/src/locales/langs/en.json +283 -0
- package/template/src/locales/langs/zh.json +283 -0
- package/template/src/main.ts +29 -0
- package/template/src/mock/auth.ts +46 -0
- package/template/src/plugins/echarts.ts +76 -0
- package/template/src/plugins/index.ts +6 -0
- package/template/src/router/core/ComponentLoader.ts +82 -0
- package/template/src/router/core/IframeRouteManager.ts +78 -0
- package/template/src/router/core/MenuProcessor.ts +280 -0
- package/template/src/router/core/RoutePermissionValidator.ts +161 -0
- package/template/src/router/core/RouteRegistry.ts +90 -0
- package/template/src/router/core/RouteTransformer.ts +132 -0
- package/template/src/router/core/RouteValidator.ts +187 -0
- package/template/src/router/core/index.ts +14 -0
- package/template/src/router/guards/afterEach.ts +34 -0
- package/template/src/router/guards/beforeEach.ts +442 -0
- package/template/src/router/index.ts +24 -0
- package/template/src/router/modules/dashboard.ts +23 -0
- package/template/src/router/modules/examples.ts +109 -0
- package/template/src/router/modules/exception.ts +46 -0
- package/template/src/router/modules/index.ts +12 -0
- package/template/src/router/modules/result.ts +32 -0
- package/template/src/router/routes/asyncRoutes.ts +9 -0
- package/template/src/router/routes/staticRoutes.ts +60 -0
- package/template/src/router/routesAlias.ts +8 -0
- package/template/src/services/auth.ts +15 -0
- package/template/src/store/index.ts +52 -0
- package/template/src/store/modules/menu.ts +109 -0
- package/template/src/store/modules/setting.ts +450 -0
- package/template/src/store/modules/user.ts +218 -0
- package/template/src/store/modules/worktab.ts +568 -0
- package/template/src/types/api/api.d.ts +86 -0
- package/template/src/types/common/index.ts +95 -0
- package/template/src/types/common/response.ts +32 -0
- package/template/src/types/component/chart.ts +324 -0
- package/template/src/types/component/index.ts +86 -0
- package/template/src/types/config/index.ts +253 -0
- package/template/src/types/directive/directive.d.ts +15 -0
- package/template/src/types/import/auto-imports.d.ts +319 -0
- package/template/src/types/import/components.d.ts +126 -0
- package/template/src/types/index.ts +22 -0
- package/template/src/types/router/index.ts +80 -0
- package/template/src/types/store/index.ts +157 -0
- package/template/src/utils/form/index.ts +9 -0
- package/template/src/utils/form/validator.ts +316 -0
- package/template/src/utils/http/contract.ts +39 -0
- package/template/src/utils/http/error.ts +182 -0
- package/template/src/utils/http/index.ts +226 -0
- package/template/src/utils/http/status.ts +18 -0
- package/template/src/utils/index.ts +31 -0
- package/template/src/utils/navigation/index.ts +10 -0
- package/template/src/utils/navigation/jump.ts +68 -0
- package/template/src/utils/navigation/route.ts +85 -0
- package/template/src/utils/navigation/worktab.ts +67 -0
- package/template/src/utils/router.ts +63 -0
- package/template/src/utils/socket/index.ts +423 -0
- package/template/src/utils/storage/index.ts +7 -0
- package/template/src/utils/storage/storage-config.ts +127 -0
- package/template/src/utils/storage/storage-key-manager.ts +97 -0
- package/template/src/utils/storage/storage.ts +250 -0
- package/template/src/utils/sys/console.ts +9 -0
- package/template/src/utils/sys/error-handle.ts +143 -0
- package/template/src/utils/sys/index.ts +2 -0
- package/template/src/utils/sys/mittBus.ts +61 -0
- package/template/src/utils/ui/animation.ts +80 -0
- package/template/src/utils/ui/colors.ts +273 -0
- package/template/src/utils/ui/emojo.ts +24 -0
- package/template/src/utils/ui/iconify-loader.ts +31 -0
- package/template/src/utils/ui/index.ts +11 -0
- package/template/src/utils/ui/loading.ts +158 -0
- package/template/src/utils/ui/tabs.ts +60 -0
- package/template/src/views/auth/forget-password/index.vue +62 -0
- package/template/src/views/auth/login/index.vue +166 -0
- package/template/src/views/auth/login/style.css +38 -0
- package/template/src/views/auth/register/index.vue +240 -0
- package/template/src/views/dashboard/console/index.vue +173 -0
- package/template/src/views/examples/analytics/index.vue +389 -0
- package/template/src/views/examples/complex-form/index.vue +395 -0
- package/template/src/views/examples/crud-workspace/index.vue +412 -0
- package/template/src/views/examples/navigation/detail/index.vue +151 -0
- package/template/src/views/examples/navigation/state/index.vue +226 -0
- package/template/src/views/examples/overview/index.vue +309 -0
- package/template/src/views/examples/permissions/index.vue +303 -0
- package/template/src/views/examples/search-table/index.vue +182 -0
- package/template/src/views/examples/search-table/search.config.ts +81 -0
- package/template/src/views/examples/search-table/service.ts +116 -0
- package/template/src/views/examples/search-table/table.config.ts +37 -0
- package/template/src/views/exception/403/index.vue +16 -0
- package/template/src/views/exception/404/index.vue +16 -0
- package/template/src/views/exception/500/index.vue +16 -0
- package/template/src/views/index/index.vue +29 -0
- package/template/src/views/index/style.scss +93 -0
- package/template/src/views/outside/Iframe.vue +42 -0
- package/template/src/views/result/fail/index.vue +28 -0
- package/template/src/views/result/success/index.vue +21 -0
- package/template/tests/e2e/auth.spec.ts +14 -0
- package/template/tests/e2e/search-table.spec.ts +154 -0
- package/template/tests/unit/adapters/auth.spec.ts +38 -0
- package/template/tests/unit/config/app-config.spec.ts +17 -0
- package/template/tests/unit/directives/highlight.spec.ts +20 -0
- package/template/tests/unit/http/contract.spec.ts +47 -0
- package/template/tests/unit/mock/search-table.spec.ts +62 -0
- package/template/tests/unit/router/examples.spec.ts +52 -0
- package/template/tsconfig.json +28 -0
- package/template/vite.config.ts +181 -0
- package/template/vitest.config.ts +27 -0
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 路由注册核心类
|
|
3
|
+
*
|
|
4
|
+
* 负责动态路由的注册、验证和管理
|
|
5
|
+
*
|
|
6
|
+
* @module router/core/RouteRegistry
|
|
7
|
+
* @author Art Design Pro Team
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
import type { Router, RouteRecordRaw } from 'vue-router'
|
|
11
|
+
import type { AppRouteRecord } from '@/types/router'
|
|
12
|
+
import { ComponentLoader } from './ComponentLoader'
|
|
13
|
+
import { RouteValidator } from './RouteValidator'
|
|
14
|
+
import { RouteTransformer } from './RouteTransformer'
|
|
15
|
+
|
|
16
|
+
export class RouteRegistry {
|
|
17
|
+
private router: Router
|
|
18
|
+
private componentLoader: ComponentLoader
|
|
19
|
+
private validator: RouteValidator
|
|
20
|
+
private transformer: RouteTransformer
|
|
21
|
+
private removeRouteFns: (() => void)[] = []
|
|
22
|
+
private registered = false
|
|
23
|
+
|
|
24
|
+
constructor(router: Router) {
|
|
25
|
+
this.router = router
|
|
26
|
+
this.componentLoader = new ComponentLoader()
|
|
27
|
+
this.validator = new RouteValidator()
|
|
28
|
+
this.transformer = new RouteTransformer(this.componentLoader)
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* 注册动态路由
|
|
33
|
+
*/
|
|
34
|
+
register(menuList: AppRouteRecord[]): void {
|
|
35
|
+
if (this.registered) {
|
|
36
|
+
console.warn('[RouteRegistry] 路由已注册,跳过重复注册')
|
|
37
|
+
return
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
// 验证路由配置
|
|
41
|
+
const validationResult = this.validator.validate(menuList)
|
|
42
|
+
if (!validationResult.valid) {
|
|
43
|
+
throw new Error(`路由配置验证失败: ${validationResult.errors.join(', ')}`)
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
// 转换并注册路由
|
|
47
|
+
const removeRouteFns: (() => void)[] = []
|
|
48
|
+
|
|
49
|
+
menuList.forEach((route) => {
|
|
50
|
+
if (route.name && !this.router.hasRoute(route.name)) {
|
|
51
|
+
const routeConfig = this.transformer.transform(route)
|
|
52
|
+
const removeRouteFn = this.router.addRoute(routeConfig as RouteRecordRaw)
|
|
53
|
+
removeRouteFns.push(removeRouteFn)
|
|
54
|
+
}
|
|
55
|
+
})
|
|
56
|
+
|
|
57
|
+
this.removeRouteFns = removeRouteFns
|
|
58
|
+
this.registered = true
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* 移除所有动态路由
|
|
63
|
+
*/
|
|
64
|
+
unregister(): void {
|
|
65
|
+
this.removeRouteFns.forEach((fn) => fn())
|
|
66
|
+
this.removeRouteFns = []
|
|
67
|
+
this.registered = false
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* 检查是否已注册
|
|
72
|
+
*/
|
|
73
|
+
isRegistered(): boolean {
|
|
74
|
+
return this.registered
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* 获取移除函数列表(用于 store 管理)
|
|
79
|
+
*/
|
|
80
|
+
getRemoveRouteFns(): (() => void)[] {
|
|
81
|
+
return this.removeRouteFns
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* 标记为已注册(用于错误处理场景,避免重复请求)
|
|
86
|
+
*/
|
|
87
|
+
markAsRegistered(): void {
|
|
88
|
+
this.registered = true
|
|
89
|
+
}
|
|
90
|
+
}
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 路由转换器
|
|
3
|
+
*
|
|
4
|
+
* 负责将菜单数据转换为 Vue Router 路由配置
|
|
5
|
+
*
|
|
6
|
+
* @module router/core/RouteTransformer
|
|
7
|
+
* @author Art Design Pro Team
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
import type { RouteRecordRaw } from 'vue-router'
|
|
11
|
+
import type { AppRouteRecord } from '@/types/router'
|
|
12
|
+
import { ComponentLoader } from './ComponentLoader'
|
|
13
|
+
import { IframeRouteManager } from './IframeRouteManager'
|
|
14
|
+
|
|
15
|
+
interface ConvertedRoute extends Omit<RouteRecordRaw, 'children'> {
|
|
16
|
+
id?: number
|
|
17
|
+
children?: ConvertedRoute[]
|
|
18
|
+
component?: RouteRecordRaw['component'] | (() => Promise<any>)
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
export class RouteTransformer {
|
|
22
|
+
private componentLoader: ComponentLoader
|
|
23
|
+
private iframeManager: IframeRouteManager
|
|
24
|
+
|
|
25
|
+
constructor(componentLoader: ComponentLoader) {
|
|
26
|
+
this.componentLoader = componentLoader
|
|
27
|
+
this.iframeManager = IframeRouteManager.getInstance()
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* 转换路由配置
|
|
32
|
+
*/
|
|
33
|
+
transform(route: AppRouteRecord, depth = 0): ConvertedRoute {
|
|
34
|
+
const { component, children, ...routeConfig } = route
|
|
35
|
+
|
|
36
|
+
// 基础路由配置
|
|
37
|
+
const converted: ConvertedRoute = {
|
|
38
|
+
...routeConfig,
|
|
39
|
+
component: undefined
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
// 处理不同类型的路由
|
|
43
|
+
if (route.meta.isIframe) {
|
|
44
|
+
this.handleIframeRoute(converted, route, depth)
|
|
45
|
+
} else if (this.isFirstLevelRoute(route, depth)) {
|
|
46
|
+
this.handleFirstLevelRoute(converted, route, component as string)
|
|
47
|
+
} else {
|
|
48
|
+
this.handleNormalRoute(converted, component as string)
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
// 递归处理子路由
|
|
52
|
+
if (children?.length) {
|
|
53
|
+
converted.children = children.map((child) => this.transform(child, depth + 1))
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
return converted
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* 判断是否为一级路由(需要 Layout 包裹)
|
|
61
|
+
*/
|
|
62
|
+
private isFirstLevelRoute(route: AppRouteRecord, depth: number): boolean {
|
|
63
|
+
return depth === 0 && (!route.children || route.children.length === 0)
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* 处理 iframe 类型路由
|
|
68
|
+
*/
|
|
69
|
+
private handleIframeRoute(
|
|
70
|
+
targetRoute: ConvertedRoute,
|
|
71
|
+
sourceRoute: AppRouteRecord,
|
|
72
|
+
depth: number
|
|
73
|
+
): void {
|
|
74
|
+
if (depth === 0) {
|
|
75
|
+
// 顶级 iframe:用 Layout 包裹
|
|
76
|
+
targetRoute.component = this.componentLoader.loadLayout()
|
|
77
|
+
targetRoute.path = this.extractFirstSegment(sourceRoute.path || '')
|
|
78
|
+
targetRoute.name = ''
|
|
79
|
+
|
|
80
|
+
targetRoute.children = [
|
|
81
|
+
{
|
|
82
|
+
...sourceRoute,
|
|
83
|
+
component: this.componentLoader.loadIframe()
|
|
84
|
+
} as ConvertedRoute
|
|
85
|
+
]
|
|
86
|
+
} else {
|
|
87
|
+
// 非顶级(嵌套)iframe:直接使用 Iframe.vue
|
|
88
|
+
targetRoute.component = this.componentLoader.loadIframe()
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
// 记录 iframe 路由
|
|
92
|
+
this.iframeManager.add(sourceRoute)
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* 处理一级菜单路由
|
|
97
|
+
*/
|
|
98
|
+
private handleFirstLevelRoute(
|
|
99
|
+
converted: ConvertedRoute,
|
|
100
|
+
route: AppRouteRecord,
|
|
101
|
+
component: string | undefined
|
|
102
|
+
): void {
|
|
103
|
+
converted.component = this.componentLoader.loadLayout()
|
|
104
|
+
converted.path = this.extractFirstSegment(route.path || '')
|
|
105
|
+
converted.name = ''
|
|
106
|
+
route.meta.isFirstLevel = true
|
|
107
|
+
|
|
108
|
+
converted.children = [
|
|
109
|
+
{
|
|
110
|
+
...route,
|
|
111
|
+
component: component ? this.componentLoader.load(component) : undefined
|
|
112
|
+
} as ConvertedRoute
|
|
113
|
+
]
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/**
|
|
117
|
+
* 处理普通路由
|
|
118
|
+
*/
|
|
119
|
+
private handleNormalRoute(converted: ConvertedRoute, component: string | undefined): void {
|
|
120
|
+
if (component) {
|
|
121
|
+
converted.component = this.componentLoader.load(component)
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
/**
|
|
126
|
+
* 提取路径的第一段
|
|
127
|
+
*/
|
|
128
|
+
private extractFirstSegment(path: string): string {
|
|
129
|
+
const segments = path.split('/').filter(Boolean)
|
|
130
|
+
return segments.length > 0 ? `/${segments[0]}` : '/'
|
|
131
|
+
}
|
|
132
|
+
}
|
|
@@ -0,0 +1,187 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 路由验证器
|
|
3
|
+
*
|
|
4
|
+
* 负责验证路由配置的合法性
|
|
5
|
+
*
|
|
6
|
+
* @module router/core/RouteValidator
|
|
7
|
+
* @author Art Design Pro Team
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
import type { AppRouteRecord } from '@/types/router'
|
|
11
|
+
import { RoutesAlias } from '../routesAlias'
|
|
12
|
+
|
|
13
|
+
export interface ValidationResult {
|
|
14
|
+
valid: boolean
|
|
15
|
+
errors: string[]
|
|
16
|
+
warnings: string[]
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
export class RouteValidator {
|
|
20
|
+
// 用于记录已经提示过的路由,避免重复提示
|
|
21
|
+
private warnedRoutes = new Set<string>()
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* 验证路由配置
|
|
25
|
+
*/
|
|
26
|
+
validate(routes: AppRouteRecord[]): ValidationResult {
|
|
27
|
+
const errors: string[] = []
|
|
28
|
+
const warnings: string[] = []
|
|
29
|
+
|
|
30
|
+
// 检测重复路由
|
|
31
|
+
this.checkDuplicates(routes, errors, warnings)
|
|
32
|
+
|
|
33
|
+
// 检测组件配置
|
|
34
|
+
this.checkComponents(routes, errors, warnings)
|
|
35
|
+
|
|
36
|
+
// 检测嵌套菜单的 /index/index 配置
|
|
37
|
+
this.checkNestedIndexComponent(routes)
|
|
38
|
+
|
|
39
|
+
return {
|
|
40
|
+
valid: errors.length === 0,
|
|
41
|
+
errors,
|
|
42
|
+
warnings
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* 检测重复路由
|
|
48
|
+
*/
|
|
49
|
+
private checkDuplicates(
|
|
50
|
+
routes: AppRouteRecord[],
|
|
51
|
+
errors: string[],
|
|
52
|
+
warnings: string[],
|
|
53
|
+
parentPath = ''
|
|
54
|
+
): void {
|
|
55
|
+
const routeNameMap = new Map<string, string>()
|
|
56
|
+
const componentPathMap = new Map<string, string>()
|
|
57
|
+
|
|
58
|
+
const checkRoutes = (routes: AppRouteRecord[], parentPath = '') => {
|
|
59
|
+
routes.forEach((route) => {
|
|
60
|
+
const currentPath = route.path || ''
|
|
61
|
+
const fullPath = this.resolvePath(parentPath, currentPath)
|
|
62
|
+
|
|
63
|
+
// 名称重复检测
|
|
64
|
+
if (route.name) {
|
|
65
|
+
const routeName = String(route.name)
|
|
66
|
+
if (routeNameMap.has(routeName)) {
|
|
67
|
+
warnings.push(`路由名称重复: "${routeName}" (${fullPath})`)
|
|
68
|
+
} else {
|
|
69
|
+
routeNameMap.set(routeName, fullPath)
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
// 组件路径重复检测
|
|
74
|
+
if (route.component && typeof route.component === 'string') {
|
|
75
|
+
const componentPath = route.component
|
|
76
|
+
if (componentPath !== RoutesAlias.Layout) {
|
|
77
|
+
const componentKey = `${parentPath}:${componentPath}`
|
|
78
|
+
if (componentPathMap.has(componentKey)) {
|
|
79
|
+
warnings.push(`组件路径重复: "${componentPath}" (${fullPath})`)
|
|
80
|
+
} else {
|
|
81
|
+
componentPathMap.set(componentKey, fullPath)
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
// 递归处理子路由
|
|
87
|
+
if (route.children?.length) {
|
|
88
|
+
checkRoutes(route.children, fullPath)
|
|
89
|
+
}
|
|
90
|
+
})
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
checkRoutes(routes, parentPath)
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/**
|
|
97
|
+
* 检测组件配置
|
|
98
|
+
*/
|
|
99
|
+
private checkComponents(
|
|
100
|
+
routes: AppRouteRecord[],
|
|
101
|
+
errors: string[],
|
|
102
|
+
warnings: string[],
|
|
103
|
+
parentPath = ''
|
|
104
|
+
): void {
|
|
105
|
+
routes.forEach((route) => {
|
|
106
|
+
const hasExternalLink = !!route.meta?.link?.trim()
|
|
107
|
+
const hasChildren = Array.isArray(route.children) && route.children.length > 0
|
|
108
|
+
const routePath = route.path || '[未定义路径]'
|
|
109
|
+
const isIframe = route.meta?.isIframe
|
|
110
|
+
|
|
111
|
+
// 如果配置了 component,则无需校验
|
|
112
|
+
if (route.component) {
|
|
113
|
+
// 递归检查子路由
|
|
114
|
+
if (route.children?.length) {
|
|
115
|
+
const fullPath = this.resolvePath(parentPath, route.path || '')
|
|
116
|
+
this.checkComponents(route.children, errors, warnings, fullPath)
|
|
117
|
+
}
|
|
118
|
+
return
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
// 一级菜单:必须指定 Layout,除非是外链或 iframe
|
|
122
|
+
if (parentPath === '' && !hasExternalLink && !isIframe) {
|
|
123
|
+
errors.push(`一级菜单(${routePath}) 缺少 component,必须指向 ${RoutesAlias.Layout}`)
|
|
124
|
+
return
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
// 非一级菜单:如果既不是外链、iframe,也没有子路由,则必须配置 component
|
|
128
|
+
if (!hasExternalLink && !isIframe && !hasChildren) {
|
|
129
|
+
errors.push(`路由(${routePath}) 缺少 component 配置`)
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
// 递归检查子路由
|
|
133
|
+
if (route.children?.length) {
|
|
134
|
+
const fullPath = this.resolvePath(parentPath, route.path || '')
|
|
135
|
+
this.checkComponents(route.children, errors, warnings, fullPath)
|
|
136
|
+
}
|
|
137
|
+
})
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/**
|
|
141
|
+
* 检测嵌套菜单的 Layout 组件配置
|
|
142
|
+
* 只有一级菜单才能使用 Layout,二级及以下菜单不能使用
|
|
143
|
+
*/
|
|
144
|
+
private checkNestedIndexComponent(routes: AppRouteRecord[], level = 1): void {
|
|
145
|
+
routes.forEach((route) => {
|
|
146
|
+
// 检查二级及以下菜单是否错误使用了 Layout
|
|
147
|
+
if (level > 1 && route.component === RoutesAlias.Layout) {
|
|
148
|
+
this.logLayoutError(route, level)
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
// 递归检查子路由
|
|
152
|
+
if (route.children?.length) {
|
|
153
|
+
this.checkNestedIndexComponent(route.children, level + 1)
|
|
154
|
+
}
|
|
155
|
+
})
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
/**
|
|
159
|
+
* 输出 Layout 组件配置错误日志
|
|
160
|
+
*/
|
|
161
|
+
private logLayoutError(route: AppRouteRecord, level: number): void {
|
|
162
|
+
const routeName = String(route.name || route.path || '未知路由')
|
|
163
|
+
const routeKey = `${routeName}_${route.path}`
|
|
164
|
+
|
|
165
|
+
// 避免重复提示
|
|
166
|
+
if (this.warnedRoutes.has(routeKey)) return
|
|
167
|
+
this.warnedRoutes.add(routeKey)
|
|
168
|
+
|
|
169
|
+
const menuTitle = route.meta?.title || routeName
|
|
170
|
+
const routePath = route.path || '/'
|
|
171
|
+
|
|
172
|
+
console.error(
|
|
173
|
+
`[路由配置错误] 菜单 "${menuTitle}" (name: ${routeName}, path: ${routePath}) 配置错误\n` +
|
|
174
|
+
` 问题: ${level}级菜单不能使用 ${RoutesAlias.Layout} 作为 component\n` +
|
|
175
|
+
` 说明: 只有一级菜单才能使用 ${RoutesAlias.Layout},二级及以下菜单应该指向具体的组件路径\n` +
|
|
176
|
+
` 当前配置: component: '${RoutesAlias.Layout}'\n` +
|
|
177
|
+
` 应该改为: component: '/your/component/path' 或留空 ''(如果是目录菜单)`
|
|
178
|
+
)
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
/**
|
|
182
|
+
* 路径解析
|
|
183
|
+
*/
|
|
184
|
+
private resolvePath(parent: string, child: string): string {
|
|
185
|
+
return [parent.replace(/\/$/, ''), child.replace(/^\//, '')].filter(Boolean).join('/')
|
|
186
|
+
}
|
|
187
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 路由核心模块导出
|
|
3
|
+
*
|
|
4
|
+
* @module router/core
|
|
5
|
+
* @author Art Design Pro Team
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
export { RouteRegistry } from './RouteRegistry'
|
|
9
|
+
export { ComponentLoader } from './ComponentLoader'
|
|
10
|
+
export { RouteValidator } from './RouteValidator'
|
|
11
|
+
export { RouteTransformer } from './RouteTransformer'
|
|
12
|
+
export { IframeRouteManager } from './IframeRouteManager'
|
|
13
|
+
export { MenuProcessor } from './MenuProcessor'
|
|
14
|
+
export { RoutePermissionValidator } from './RoutePermissionValidator'
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { nextTick } from 'vue'
|
|
2
|
+
import { useSettingStore } from '@/store/modules/setting'
|
|
3
|
+
import { Router } from 'vue-router'
|
|
4
|
+
import NProgress from 'nprogress'
|
|
5
|
+
import { useCommon } from '@/hooks/core/useCommon'
|
|
6
|
+
import { loadingService } from '@/utils/ui'
|
|
7
|
+
import { getPendingLoading, resetPendingLoading } from './beforeEach'
|
|
8
|
+
|
|
9
|
+
/** 路由全局后置守卫 */
|
|
10
|
+
export function setupAfterEachGuard(router: Router) {
|
|
11
|
+
const { scrollToTop } = useCommon()
|
|
12
|
+
|
|
13
|
+
router.afterEach(() => {
|
|
14
|
+
scrollToTop()
|
|
15
|
+
|
|
16
|
+
// 关闭进度条
|
|
17
|
+
const settingStore = useSettingStore()
|
|
18
|
+
if (settingStore.showNprogress) {
|
|
19
|
+
NProgress.done()
|
|
20
|
+
// 确保进度条完全移除,避免残影
|
|
21
|
+
setTimeout(() => {
|
|
22
|
+
NProgress.remove()
|
|
23
|
+
}, 600)
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
// 关闭 loading 效果
|
|
27
|
+
if (getPendingLoading()) {
|
|
28
|
+
nextTick(() => {
|
|
29
|
+
loadingService.hideLoading()
|
|
30
|
+
resetPendingLoading()
|
|
31
|
+
})
|
|
32
|
+
}
|
|
33
|
+
})
|
|
34
|
+
}
|