企业级应用多标签页页面管理方案，包含页面缓存和刷新。 #13526

luckygc · 2025-06-25T05:51:00Z

luckygc
Jun 25, 2025

核心概念

组件name控制缓存，组件key控制重渲染

vue-router+pinia项目的多页面管理，适用于组件复用作为页面，需要单独缓存每个实例的情况，以及优雅的页面刷新。

实现思路

1.页面刷新

vue通过key来标识每个组件，key变化会导致组件重新渲染。那么就可以通过改变key来实现组件的刷新。

定义一个响应Map来存储页面组件对应的key，需要刷新页面那就更新组件对应的key，就可以控制页面重渲染，也就是刷新

2.页面缓存

在复用组件的作为页面的情况下，由于组件name一样，vue缓存的是同一个实例，那么可以通过包裹组件的方式解决，包裹的组件name可以自定义。

核心代码

由于有组件复用的情况，所以统一使用路由的fullPath来作为标识，组件name和组件key都和fullPath关联。

import {defineStore} from "pinia";
import {type Component, computed, defineComponent, h, markRaw, ref, shallowRef} from "vue";
import {type RouteLocationNormalizedLoadedGeneric, useRoute, useRouter} from "vue-router";

type Page = Pick<RouteLocationNormalizedLoadedGeneric, 'fullPath' | 'name' | 'meta' | 'path'>;

const needKeepAlive = (page: Page | RouteLocationNormalizedLoadedGeneric): boolean => {
    return page.meta?.['keepAlive'] === true;
}

const computeIfAbsent = <K, V>(map: Map<K, V>, key: K, mappingFunction: (key?: K) => V): V => {
    if (map.has(key)) {
        return map.get(key)!;
    }

    const value = mappingFunction(key);
    map.set(key, value);
    return value;
}

// 包裹组件定义缓存,key:包裹组件name,value:包裹组件定义
const wrapperPageComponentCache = new Map<string, Component>();

// 计算页面组件的名称,即使内存里组件name可以随意，但是为了符合规范，还是替换特殊符号
const computeWrappedPageComponentName = (route: RouteLocationNormalizedLoadedGeneric | Page): string => {
    return 'Page' + route.fullPath.replace(/[^a-zA-Z0-9]/g, "-");
}

/**
 * 包装页面组件,用于多实例页面的缓存
 * @param pageComponent 原始页面组件
 * @param route 路由
 */
const wrapPageComponent = (pageComponent: Component, route: RouteLocationNormalizedLoadedGeneric) => {
    if (!pageComponent) {
        return null;
    }

    return computeIfAbsent(wrapperPageComponentCache, computeWrappedPageComponentName(route), key => {
        return markRaw(
            defineComponent({
                name: key,
                setup(props, {attrs, slots}) {
                    return () => h(pageComponent, {...attrs, ...props}, slots);
                },
            })
        );
    });
}

const getKeySuffix = () => {
    return `_${Date.now()}`;
}

const storeSetup = () => {
    const router = useRouter();
    const route = useRoute();
    // 页面数组
    const pages = shallowRef<Page[]>([]);
    // 每个页面组件的Key的后缀,用于刷新组件
    const _componentKeySuffixMap = ref<Map<string, string>>(new Map());
    // 缓存
    const keepAliveInclude = computed(() => pages.value.filter(needKeepAlive).map(computeWrappedPageComponentName));
    // 非页签页面路由名称
    const specialRouteNames = ['Index', 'Login', 'NotFound'];

    const findPageByRouteFullPath = (fullPath: string): Page | undefined => {
        return pages.value.find(page => page.fullPath === fullPath);
    }

    const afterRouteChange = (to: RouteLocationNormalizedLoadedGeneric) => {
        // 无需管理的页面
        if (specialRouteNames.findIndex(name => to.name === name) > -1) {
            return;
        }

        // 检查页面是否已存在
        if (findPageByRouteFullPath(to.fullPath)) {
            return;
        }

        // 新建并追加page
        const page: Page = {
            fullPath: to.fullPath,
            path: to.path,
            name: to.name,
            meta: {...to.meta},
        };

        pages.value = [...pages.value, page];
    }

    const closeCurrentPage = async () => {
        const currentPage = findPageByRouteFullPath(route.fullPath);
        if (!currentPage) {
            return;
        }

        return closePage(currentPage.fullPath);
    }

    // 关闭指定路由页面
    const closePage = async (routeFullPath: string) => {
        const waitClosePage = findPageByRouteFullPath(routeFullPath);
        if (!waitClosePage) {
            throw new Error(`页面{fullPath=${routeFullPath}}不存在`);
        }

        pages.value = pages.value.filter(page => page.fullPath !== routeFullPath);
        _componentKeySuffixMap.value.delete(routeFullPath);
        wrapperPageComponentCache.delete(computeWrappedPageComponentName(waitClosePage))

        // 如果关闭的不是当前激活的页面,不需要跳转
        if (routeFullPath !== route.fullPath) {
            return;
        }

        if (pages.value.length === 0) {
            return await router.push('/')
        }

        // 跳转到最后一个页面
        return await router.push(pages.value[pages.value.length - 1]!.fullPath);
    }

    /**
     * 计算页面组件的Key,路由fullPath加时间戳，用于强制刷新组件
     */
    const computePageComponentKey = (r: RouteLocationNormalizedLoadedGeneric): string => {
        const fullPath = r.fullPath;
        const keySuffix = computeIfAbsent(_componentKeySuffixMap.value, fullPath, () => getKeySuffix())
        return `${fullPath}${keySuffix}`;
    }

    // 刷新当前页面
    const refreshPage = async () => {
        const currentPage = findPageByRouteFullPath(route.fullPath);
        if (!currentPage) {
            return;
        }

        _componentKeySuffixMap.value.set(currentPage.fullPath, getKeySuffix());
    }

    // 关闭其他页面
    const closeOtherPage = async () => {
        const currentPage = findPageByRouteFullPath(route.fullPath);
        if (!currentPage || pages.value.length <= 1) {
            return;
        }

        const pagesToClose = pages.value.filter(page => page.fullPath !== currentPage.fullPath);
        pages.value = [currentPage];

        for (const page of pagesToClose) {
            _componentKeySuffixMap.value.delete(page.fullPath);
            wrapperPageComponentCache.delete(computeWrappedPageComponentName(page))
        }
    }

    // 关闭所有页面（优化：批量操作减少响应式更新）
    const closeAllPage = async () => {
        pages.value = [];
        _componentKeySuffixMap.value.clear();
        wrapperPageComponentCache.clear();
        return await router.push('/')
    }

    return {
       
8000
 pages,
        keepAliveInclude,

        afterRouteChange,
        computePageComponentKey,
        wrapPageComponent,

        closeCurrentPage,
        closePage,
        refreshPage,
        closeOtherPage,
        closeAllPage,
    };
}

export const usePageStore = defineStore("page", storeSetup);

使用方式

路由监听

router.afterEach((to) => {
    usePageStore().afterRouteChange(to);
})

router-view

<template>
  <router-view v-slot="{ Component, route }">
    <keep-alive :include="pageStore.keepAliveInclude" :max="15">
      <component :is="pageStore.wrapPageComponent(Component,route)"
                 :key="pageStore.computePageComponentKey(route)"/>
    </keep-alive>
  </router-view>
</template>

页签管理

<template>
  <ElTabs :model-value="route.fullPath"
          type="border-card"
          closable
          @tab-click="({paneName})=> router.push(paneName as string)"
          @tab-remove="name => pageStore.closePage(name as string)"
          style="width: calc(100% - 135px);">
    <ElTabPane v-for="page in pageStore.pages"
               :key="page.fullPath"
               :label="page.meta?.['title'] as string"
               :name="page.fullPath">
    </ElTabPane>
  </ElTabs>
</template>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Vue

企业级应用多标签页页面管理方案，包含页面缓存和刷新。 #13526

Uh oh!

{{title}}

Uh oh!

Replies: 0 comments

Select a reply

Uh oh!

Vue

企业级应用多标签页页面管理方案，包含页面缓存和刷新。 #13526

Uh oh!

luckygc Jun 25, 2025

实现思路

1.页面刷新

2.页面缓存

核心代码

使用方式

Replies: 0 comments

luckygc
Jun 25, 2025