如何使用 Vue Router 的 meta 屬性實現多種功能

更新時間：2024年06月27日 15:03:05 作者：禾小毅

在Vue.js中,Vue Router 提供了強大的路由管理功能,通過meta屬性,我們可以在路由定義中添加自定義元數據,以實現訪問控制、頁面標題設置、角色權限管理、頁面過渡效果,本文將總結如何使用 meta 屬性來實現這些常見的功能,感興趣的朋友一起看看吧

在 Vue.js 中，Vue Router 提供了強大的路由管理功能。通過 meta 屬性，我們可以在路由定義中添加自定義元數據，以實現訪問控制、頁面標題設置、角色權限管理、頁面過渡效果等多種功能。本文將總結如何使用 meta 屬性來實現這些常見的功能。

1. 設置頁面標題

可以在路由的 meta 屬性中指定頁面標題，并在路由守衛(wèi)中動態(tài)設置 document.title。

const routes = [
    {
        path: '/home',
        name: 'Home',
        component: () => import('@/views/Home'),
        meta: {
            title: 'Home Page'
        }
    },
    {
        path: '/about',
        name: 'About',
        component: () => import('@/views/About'),
        meta: {
            title: 'About Us'
        }
    }
];
router.beforeEach((to, from, next) => {
    if (to.meta.title) {
        document.title = to.meta.title;
    }
    next();
});

2. 角色權限管理

通過在 meta 屬性中指定允許訪問的角色，可以實現不同用戶角色的權限管理。

const routes = [
    {
        path: '/admin',
        name: 'Admin',
        component: () => import('@/views/Admin'),
        meta: {
            requiresAuth: true,
            roles: ['admin']
        }
    },
    {
        path: '/user',
        name: 'User',
        component: () => import('@/views/User'),
        meta: {
            requiresAuth: true,
            roles: ['user', 'admin']
        }
    }
];
function getUserRole() {
    return localStorage.getItem('userRole');
}
router.beforeEach((to, from, next) => {
    if (to.matched.some(record => record.meta.requiresAuth)) {
        const userRole = getUserRole();
        if (!userRole) {
            next({ path: '/login' });
        } else if (to.meta.roles && to.meta.roles.indexOf(userRole) === -1) {
            next({ path: '/unauthorized' });
        } else {
            next();
        }
    } else {
        next();
    }
});

3. 頁面過渡效果

在 meta 屬性中指定頁面過渡效果，并在主組件中使用標簽。

const routes = [
    {
        path: '/home',
        name: 'Home',
        component: () => import('@/views/Home'),
        meta: {
            transition: 'slide-left'
        }
    },
    {
        path: '/about',
        name: 'About',
        component: () => import('@/views/About'),
        meta: {
            transition: 'fade'
        }
    }
];
// 在主組件中使用<transition>，例如App.vue
<template>
    <div id="app">
        <transition :name="$route.meta.transition">
            <router-view></router-view>
        </transition>
    </div>
</template>

4. 頁面緩存

使用 meta 屬性來控制頁面緩存，通過 keep-alive 組件實現。

const routes = [
    {
        path: '/home',
        name: 'Home',
        component: () => import('@/views/Home'),
        meta: {
            keepAlive: true
        }
    },
    {
        path: '/about',
        name: 'About',
        component: () => import('@/views/About'),
        meta: {
            keepAlive: false
        }
    }
];
// 在主組件中使用<keep-alive>
<template>
    <div id="app">
        <keep-alive>
            <router-view v-if="$route.meta.keepAlive"></router-view>
        </keep-alive>
        <router-view v-if="!$route.meta.keepAlive"></router-view>
    </div>
</template>

5. 頁面加載指示器

在路由切換時顯示加載指示器，通過 meta 屬性控制。

const routes = [
    {
        path: '/home',
        name: 'Home',
        component: () => import('@/views/Home'),
        meta: {
            showLoading: true
        }
    },
    {
        path: '/about',
        name: 'About',
        component: () => import('@/views/About'),
        meta: {
            showLoading: false
        }
    }
];
router.beforeEach((to, from, next) => {
    if (to.meta.showLoading) {
        // 顯示加載指示器
        showLoadingIndicator();
    }
    next();
});
router.afterEach(() => {
    // 隱藏加載指示器
    hideLoadingIndicator();
});

6. 路由動畫

在路由切換時使用不同的動畫效果，通過 meta 屬性指定。

const routes = [
    {
        path: '/home',
        name: 'Home',
        component: () => import('@/views/Home'),
        meta: {
            animation: 'slide-left'
        }
    },
    {
        path: '/about',
        name: 'About',
        component: () => import('@/views/About'),
        meta: {
            animation: 'slide-right'
        }
    }
];
// 在App.vue中使用<transition>標簽
<template>
    <div id="app">
        <transition :name="$route.meta.animation">
            <router-view></router-view>
        </transition>
    </div>
</template>