@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,74 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* useAuth - 权限验证管理
|
|
3
|
+
*
|
|
4
|
+
* 提供统一的权限验证功能,支持前端和后端两种权限模式。
|
|
5
|
+
* 用于控制页面按钮、操作等功能的显示和访问权限。
|
|
6
|
+
*
|
|
7
|
+
* ## 主要功能
|
|
8
|
+
*
|
|
9
|
+
* 1. 权限检查 - 检查用户是否拥有指定的权限标识
|
|
10
|
+
* 2. 双模式支持 - 自动适配前端模式和后端模式的权限验证
|
|
11
|
+
* 3. 前端模式 - 从用户信息中获取按钮权限列表(如 ['add', 'edit', 'delete'])
|
|
12
|
+
* 4. 后端模式 - 从路由 meta 配置中获取权限列表(如 [{ authMark: 'add' }])
|
|
13
|
+
*
|
|
14
|
+
* ## 使用示例
|
|
15
|
+
*
|
|
16
|
+
* ```typescript
|
|
17
|
+
* const { hasAuth } = useAuth()
|
|
18
|
+
*
|
|
19
|
+
* // 检查是否有新增权限
|
|
20
|
+
* if (hasAuth('add')) {
|
|
21
|
+
* // 显示新增按钮
|
|
22
|
+
* }
|
|
23
|
+
*
|
|
24
|
+
* // 在模板中使用
|
|
25
|
+
* <el-button v-if="hasAuth('edit')">编辑</el-button>
|
|
26
|
+
* <el-button v-if="hasAuth('delete')">删除</el-button>
|
|
27
|
+
* ```
|
|
28
|
+
*
|
|
29
|
+
* @module useAuth
|
|
30
|
+
* @author Art Design Pro Team
|
|
31
|
+
*/
|
|
32
|
+
|
|
33
|
+
import { useRoute } from 'vue-router'
|
|
34
|
+
import { storeToRefs } from 'pinia'
|
|
35
|
+
import { useUserStore } from '@/store/modules/user'
|
|
36
|
+
import { useAppMode } from '@/hooks/core/useAppMode'
|
|
37
|
+
import type { AppRouteRecord } from '@/types/router'
|
|
38
|
+
|
|
39
|
+
type AuthItem = NonNullable<AppRouteRecord['meta']['authList']>[number]
|
|
40
|
+
|
|
41
|
+
const userStore = useUserStore()
|
|
42
|
+
|
|
43
|
+
export const useAuth = () => {
|
|
44
|
+
const route = useRoute()
|
|
45
|
+
const { isFrontendMode } = useAppMode()
|
|
46
|
+
const { info } = storeToRefs(userStore)
|
|
47
|
+
|
|
48
|
+
// 前端按钮权限(例如:['add', 'edit'])
|
|
49
|
+
const frontendAuthList = info.value?.buttons ?? []
|
|
50
|
+
|
|
51
|
+
// 后端路由 meta 配置的权限列表(例如:[{ authMark: 'add' }])
|
|
52
|
+
const backendAuthList: AuthItem[] = Array.isArray(route.meta.authList)
|
|
53
|
+
? (route.meta.authList as AuthItem[])
|
|
54
|
+
: []
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* 检查是否拥有某权限标识(前后端模式通用)
|
|
58
|
+
* @param auth 权限标识
|
|
59
|
+
* @returns 是否有权限
|
|
60
|
+
*/
|
|
61
|
+
const hasAuth = (auth: string): boolean => {
|
|
62
|
+
// 前端模式
|
|
63
|
+
if (isFrontendMode.value) {
|
|
64
|
+
return frontendAuthList.includes(auth)
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
// 后端模式
|
|
68
|
+
return backendAuthList.some((item) => item?.authMark === auth)
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
return {
|
|
72
|
+
hasAuth
|
|
73
|
+
}
|
|
74
|
+
}
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* useCeremony - 节日庆祝管理
|
|
3
|
+
*
|
|
4
|
+
* 提供节日烟花效果和祝福文本展示功能,为系统增添节日氛围。
|
|
5
|
+
* 自动检测当前日期是否为节日,并在首次进入时播放烟花动画和显示祝福语。
|
|
6
|
+
*
|
|
7
|
+
* ## 主要功能
|
|
8
|
+
*
|
|
9
|
+
* 1. 节日检测 - 自动匹配当前日期与节日配置列表,支持单日和跨日期节日
|
|
10
|
+
* 2. 烟花动画 - 播放节日烟花特效,支持自定义图片和触发次数
|
|
11
|
+
* 3. 祝福文本 - 烟花结束后显示节日祝福文本
|
|
12
|
+
* 4. 状态管理 - 记录烟花播放状态,避免重复播放
|
|
13
|
+
* 5. 清理机制 - 提供清理方法,支持手动停止和重置
|
|
14
|
+
*
|
|
15
|
+
* ## 使用示例
|
|
16
|
+
*
|
|
17
|
+
* ```typescript
|
|
18
|
+
* // 在配置文件中定义节日
|
|
19
|
+
* // 单日节日
|
|
20
|
+
* {
|
|
21
|
+
* date: '2024-12-25',
|
|
22
|
+
* name: '圣诞节',
|
|
23
|
+
* image: christmasImage,
|
|
24
|
+
* count: 3 // 可选,不设置则使用默认值 3 次
|
|
25
|
+
* scrollText: 'Merry Christmas!',
|
|
26
|
+
* }
|
|
27
|
+
*
|
|
28
|
+
* // 跨日期节日
|
|
29
|
+
* {
|
|
30
|
+
* date: '2025-11-07',
|
|
31
|
+
* endDate: '2025-11-10',
|
|
32
|
+
* name: 'v3.0 测试阶段',
|
|
33
|
+
* image: '',
|
|
34
|
+
* count: 5 // 自定义烟花播放次数
|
|
35
|
+
* scrollText: '系统 v3.0 测试阶段正式开启!',
|
|
36
|
+
* }
|
|
37
|
+
* ```
|
|
38
|
+
*
|
|
39
|
+
* @module useCeremony
|
|
40
|
+
* @author Art Design Pro Team
|
|
41
|
+
*/
|
|
42
|
+
|
|
43
|
+
import { useTimeoutFn, useIntervalFn, useDateFormat } from '@vueuse/core'
|
|
44
|
+
import { storeToRefs } from 'pinia'
|
|
45
|
+
import { computed } from 'vue'
|
|
46
|
+
import { useSettingStore } from '@/store/modules/setting'
|
|
47
|
+
import { mittBus } from '@/utils/sys'
|
|
48
|
+
import { festivalConfigList } from '@/config/modules/festival'
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* 节日庆祝配置常量
|
|
52
|
+
*/
|
|
53
|
+
const FESTIVAL_CONFIG = {
|
|
54
|
+
/** 初始延迟(毫秒) */
|
|
55
|
+
INITIAL_DELAY: 300,
|
|
56
|
+
/** 烟花播放间隔(毫秒) */
|
|
57
|
+
FIREWORK_INTERVAL: 1000,
|
|
58
|
+
/** 文本显示延迟(毫秒) */
|
|
59
|
+
TEXT_DELAY: 2000,
|
|
60
|
+
/** 默认烟花播放次数 */
|
|
61
|
+
DEFAULT_FIREWORKS_COUNT: 3
|
|
62
|
+
} as const
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* 节日庆祝功能
|
|
66
|
+
* 提供节日烟花效果和祝福文本展示
|
|
67
|
+
*/
|
|
68
|
+
export function useCeremony() {
|
|
69
|
+
const settingStore = useSettingStore()
|
|
70
|
+
const { holidayFireworksLoaded, isShowFireworks } = storeToRefs(settingStore)
|
|
71
|
+
|
|
72
|
+
let fireworksInterval: { pause: () => void } | null = null
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* 检查日期是否在节日范围内
|
|
76
|
+
* @param currentDate 当前日期
|
|
77
|
+
* @param festivalDate 节日开始日期
|
|
78
|
+
* @param festivalEndDate 节日结束日期(可选)
|
|
79
|
+
*/
|
|
80
|
+
const isDateInRange = (
|
|
81
|
+
currentDate: string,
|
|
82
|
+
festivalDate: string,
|
|
83
|
+
festivalEndDate?: string
|
|
84
|
+
): boolean => {
|
|
85
|
+
if (!festivalEndDate) {
|
|
86
|
+
// 单日节日
|
|
87
|
+
return currentDate === festivalDate
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
// 跨日期节日
|
|
91
|
+
const current = new Date(currentDate)
|
|
92
|
+
const start = new Date(festivalDate)
|
|
93
|
+
const end = new Date(festivalEndDate)
|
|
94
|
+
|
|
95
|
+
return current >= start && current <= end
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* 获取当前日期对应的节日数据
|
|
100
|
+
*/
|
|
101
|
+
const currentFestivalData = computed(() => {
|
|
102
|
+
const currentDate = useDateFormat(new Date(), 'YYYY-MM-DD').value
|
|
103
|
+
return festivalConfigList.find((item) => isDateInRange(currentDate, item.date, item.endDate))
|
|
104
|
+
})
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* 更新节日日期到 store
|
|
108
|
+
*/
|
|
109
|
+
const updateFestivalDate = () => {
|
|
110
|
+
settingStore.setFestivalDate(currentFestivalData.value?.date || '')
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* 触发烟花效果
|
|
115
|
+
*/
|
|
116
|
+
const triggerFirework = () => {
|
|
117
|
+
mittBus.emit('triggerFireworks', currentFestivalData.value?.image)
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
/**
|
|
121
|
+
* 完成烟花效果后显示文本
|
|
122
|
+
*/
|
|
123
|
+
const showFestivalText = () => {
|
|
124
|
+
settingStore.setholidayFireworksLoaded(true)
|
|
125
|
+
|
|
126
|
+
useTimeoutFn(() => {
|
|
127
|
+
settingStore.setShowFestivalText(true)
|
|
128
|
+
updateFestivalDate()
|
|
129
|
+
}, FESTIVAL_CONFIG.TEXT_DELAY)
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/**
|
|
133
|
+
* 启动烟花循环
|
|
134
|
+
*/
|
|
135
|
+
const startFireworksLoop = () => {
|
|
136
|
+
let playedCount = 0
|
|
137
|
+
// 使用节日配置的播放次数,如果没有则使用默认值
|
|
138
|
+
const count = currentFestivalData.value?.count ?? FESTIVAL_CONFIG.DEFAULT_FIREWORKS_COUNT
|
|
139
|
+
|
|
140
|
+
const { pause } = useIntervalFn(() => {
|
|
141
|
+
triggerFirework()
|
|
142
|
+
playedCount++
|
|
143
|
+
|
|
144
|
+
if (playedCount >= count) {
|
|
145
|
+
pause()
|
|
146
|
+
showFestivalText()
|
|
147
|
+
}
|
|
148
|
+
}, FESTIVAL_CONFIG.FIREWORK_INTERVAL)
|
|
149
|
+
|
|
150
|
+
fireworksInterval = { pause }
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
/**
|
|
154
|
+
* 开启节日庆祝
|
|
155
|
+
*/
|
|
156
|
+
const openFestival = () => {
|
|
157
|
+
if (!currentFestivalData.value || !isShowFireworks.value) {
|
|
158
|
+
return
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
const { start } = useTimeoutFn(startFireworksLoop, FESTIVAL_CONFIG.INITIAL_DELAY)
|
|
162
|
+
start()
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
/**
|
|
166
|
+
* 清理烟花效果
|
|
167
|
+
*/
|
|
168
|
+
const cleanup = () => {
|
|
169
|
+
if (fireworksInterval) {
|
|
170
|
+
fireworksInterval.pause()
|
|
171
|
+
fireworksInterval = null
|
|
172
|
+
}
|
|
173
|
+
settingStore.setShowFestivalText(false)
|
|
174
|
+
updateFestivalDate()
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
return {
|
|
178
|
+
openFestival,
|
|
179
|
+
cleanup,
|
|
180
|
+
holidayFireworksLoaded,
|
|
181
|
+
currentFestivalData,
|
|
182
|
+
isShowFireworks
|
|
183
|
+
}
|
|
184
|
+
}
|