使用 Vue Router 的 meta 属性实现多种功能

news2024/12/25 12:15:12

在 Vue.js 中，Vue Router 提供了强大的路由管理功能。通过 meta 属性，我们可以在路由定义中添加自定义元数据，以实现访问控制、页面标题设置、角色权限管理、页面过渡效果等多种功能。本文将总结如何使用 meta 属性来实现这些常见的功能。

1. 设置页面标题

可以在路由的 meta 属性中指定页面标题，并在路由守卫中动态设置 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>