【vue-router】vue-router如何实现动态路由

✨✨ 欢迎大家来到景天科技苑✨✨

🎈🎈 养成好习惯，先赞后看哦~🎈🎈

🏆 作者简介：景天科技苑
🏆《头衔》：大厂架构师，华为云开发者社区专家博主，阿里云开发者社区专家博主，CSDN全栈领域优质创作者，掘金优秀博主，51CTO博客专家等。
🏆《博客》：Python全栈，Golang开发，云原生开发，前后端框架，PyQt5和Tkinter桌面开发，小程序开发，人工智能，js逆向，App逆向，网络系统安全，数据分析，Django，fastapi，flask等框架，云原生K8S集群搭建与管理，linux，shell脚本等实操经验，网站搭建，数据库等分享。

所属的专栏：前端零基础，实战进阶教学
景天的主页：景天科技苑

Vue-Router动态路由

在构建基于Vue.js的单页面应用（SPA）时，Vue Router是一个不可或缺的工具。它提供了声明式的路由功能，使开发者能够轻松地管理和控制应用内的导航逻辑。动态路由是Vue Router中的一项重要特性，它允许我们根据运行时的数据来动态地匹配路由。这对于需要根据用户输入或后端响应来调整应用行为的场景尤其有用。本文将详细介绍动态路由的概念、作用及其在Vue Router中的具体实现，并通过一系列实际案例来展示如何有效地使用这项功能。

一、动态路由的基本概念与作用

动态路由是指在路由定义中包含动态部分的路由，这些部分通常使用占位符（如:id）来表示，实际的值会在导航发生时根据具体情况填充进去。动态路由的一个主要用途是在不知道具体值的情况下，为一组相似的资源创建共享的路由路径。

动态路由具有以下优势：

1. 灵活性：允许在运行时根据数据变化来确定路由路径。
2. 可维护性：减少重复路由定义的数量，使得路由管理更为简洁。
3. 扩展性：容易为新资源或类别添加路由，无需大幅改动现有的路由配置。

二、动态路由的基本用法

假设我们需要为每一个用户创建一个个人资料页面，我们可以定义一个动态路由来实现这一点。

import Vue from 'vue';
import VueRouter from 'vue-router';
import UserProfile from './components/UserProfile.vue';

Vue.use(VueRouter);

const routes = [
  // 动态路由定义
  { path: '/user/:id', component: UserProfile }
];

const router = new VueRouter({
  routes // (缩写) 相当于 routes: routes
});

new Vue({
  router,
  render: h => h(App)
}).$mount('#app');

在UserProfile组件中，我们可以通过$route.params访问传递过来的动态参数：

<template>
  <div>
    <h1>User Profile</h1>
    <p>UserID: {{ $route.params.id }}</p>
  </div>
</template>

<script>
export default {
  created() {
    console.log('User ID:', this.$route.params.id);
  }
};
</script>

动态路由不仅仅限于单一参数，还可以定义多个参数来匹配更复杂的路径结构。

const routes = [
  { path: '/user/:id/post/:postId', component: PostDetail }
];

// PostDetail 组件
export default {
  created() {
    console.log('User ID:', this.$route.params.id);
    console.log('Post ID:', this.$route.params.postId);
  }
};

三、动态路由的详细用法与案例

1. 动态路由与异步组件

在大型应用中，为了避免首屏加载时间过长，我们可能会使用异步组件来延迟加载某些路由对应的组件。

const routes = [
  { path: '/user/:id', component: () => import('./components/UserProfile.vue') }
];

const router = new VueRouter({
  routes
});

new Vue({
  router,
  render: h => h(App)
}).$mount('#app');

2. 动态添加路由

Vue Router 3.5.0版本开始引入了addRoute方法，它允许我们在应用程序运行时动态添加路由。通过这种方式，我们可以在用户登录后或其他特定操作后动态地添加新的路由。

使用addRoute方法

import Vue from 'vue';
import VueRouter from 'vue-router';
import Home from './components/Home.vue';
import About from './components/About.vue';
import DynamicComponent from './components/DynamicComponent.vue';

Vue.use(VueRouter);

const router = new VueRouter({
  routes: [
    // 静态路由
    { path: '/', component: Home },
    { path: '/about', component: About },
  ],
});

// 动态添加路由的函数
function addDynamicRoute() {
  router.addRoute({ path: '/dynamic', component: DynamicComponent });
}

// 在某个操作中调用动态添加路由
addDynamicRoute();

调用addDynamicRoute函数后，新的路由将被添加到路由表中，并且可以通过/dynamic路径访问。

需要注意的是，在Vue Router 3.0版本中，我们可以使用router.addRoutes方法动态添加路由。但这种方法在3.5.0版本后被addRoute方法取代。

使用Vuex保存动态路由

在一些复杂的应用场景中，我们可能需要在不同组件或模块间共享动态路由信息。这时，我们可以使用Vuex或其他状态管理工具来保存和管理动态路由。

import Vue from 'vue';
import Vuex from 'vuex';
import VueRouter from 'vue-router';
import Home from './components/Home.vue';
import About from './components/About.vue';
import DynamicComponent from './components/DynamicComponent.vue';

Vue.use(Vuex);
Vue.use(VueRouter);

const store = new Vuex.Store({
  state: {
    dynamicRoutes: [],
  },
  mutations: {
    addRoute(state, route) {
      state.dynamicRoutes.push(route);
    },
  },
});

const router = new VueRouter({
  routes: [
    // 静态路由
    { path: '/', component: Home },
    { path: '/about', component: About },
  ],
});

// 动态添加路由的函数
function addDynamicRoute(route) {
  store.commit('addRoute', route);
  router.addRoute(route);
}

// 在某个操作中调用动态添加路由
addDynamicRoute({ path: '/dynamic', component: DynamicComponent });

在上面的示例中，我们使用Vuex store来保存动态路由，并在需要时通过store.commit方法更新store中的路由信息。然后，我们调用router.addRoute方法将新的路由添加到Vue Router实例中。

3. 动态路由与命名视图

在复杂的SPA中，我们可能会有多个路由组件需要同时渲染在同一页面的不同区域。这时候可以使用命名视图来实现。

const routes = [
  {
    path: '/user/:id',
    component: {
      template: `
        <div>
          <header>
            <Header />
          </header>
          <main>
            <router-view name="main"></router-view>
            <router-view name="sidebar"></router-view>
          </main>
        </div>
      `,
      components: { Header },
    },
    children: [
      { path: '', component: UserProfile, name: 'UserProfile' },
      { path: 'settings', component: Settings, name: 'UserSettings' }
    ]
  }
];

// UserProfile 组件
export default {
  name: 'UserProfile',
  template: `
    <div>
      <router-view name="sidebar"></router-view>
      <section>
        <UserProfileMain />
      </section>
    </div>
  `,
  components: { UserProfileMain }
};

// Settings 组件
export default {
  name: 'Settings',
  template: `
    <div>
      <router-view name="sidebar"></router-view>
      <section>
        <UserProfileSettings />
      </section>
    </div>
  `,
  components: { UserProfileSettings }
};

4. 动态路由与路由元信息

有时候我们需要在路由对象上附加上一些元信息，例如页面标题、是否需要认证等，这些信息可以在组件中通过$route.meta访问。

const routes = [
  { path: '/user/:id', component: UserProfile, meta: { title: 'User Profile' } }
];

// UserProfile 组件
export default {
  created() {
    document.title = this.$route.meta.title;
  }
};

5. 动态路由与嵌套路由

对于复杂的SPA，考虑使用嵌套路由来更好地组织路由结构。

const routes = [
  {
    path: '/user/:id',
    component: User,
    children: [
      // 匹配 /user/:id
      { path: '', component: UserHome },
      // 匹配 /user/:id/profile
      { path: 'profile', component: UserProfile },
      // 匹配 /user/:id/posts
      { path: 'posts', component: UserPosts }
    ]
  }
];

要注意，以/开头的嵌套路径会被当作根路径。这让你充分地使用嵌套组件而无须设置嵌套的路径。