详解Vue 路由组件传参的 8 种方式

我们在开发单页面应用时，有时需要进入某个路由后基于参数从服务器获取数据，那么我们首先要获取路由传递过来的参数，从而完成服务器请求，所以，我们需要了解路由传参的几种方式，以下方式同 vue-router@4 。

编程式路由传参

除了使用 <router-link> 创建 a 标签来定义导航链接，我们还可以借助 router 的实例方法，通过编写代码来实现。

1. 通过 params 传递

路由配置

路径参数 用冒号 : 表示。

				?

									const routes = [

									 // 动态段以冒号开始

									 { path: 'details/:id', name: "details", component: Details },

									]

router.push() 方法的参数可以是一个字符串路径，或者一个描述地址的对象。

				?

									const Home = {

									 template: '<div @click="toDetails">To Details</div>',

									 metheds: {

									  toDetails() {

									   // 字符串路径

									   this.$router.push('/details/001')

									   // 带有路径的对象

									   this.$router.push({path: '/details/001'})

									   // 命名路由，路由配置时，需要 name 字段

									   this.$router.push({ name: 'details', params: { id: '001' } })

									  }

									 }

									}

注意，如果提供了 path ， params 会被忽略：

				?

									// `params` 不能与 `path` 一起使用

									router.push({ path: '/details', params: { id: '001' } }) // -> /details

组件获取数据

当一个路由被匹配时，它的 params 的值将在每个组件中以 this.$route.params 的形式暴露出来。

				?

									const Details = {

									 template: '<div>Details {{ $route.params.id }} </div>',

									 created() {

									  // 监听路由变化

									  this.$watch(

									   () => this.$route.params,

									   (toParams, previousParams) => {

									    // 对路由变化做出响应...

									   }

									  )

									 },

									}

2. 通过 query 传递

这种情况下 query （查询参数）传递的参数会显示在 url 后面，如： /details/001?kind=car 。

路由配置

使用 query 时，以下三种方式都是可行的：

				?

									this.$router.push('/details/001?kind=car')

									this.$router.push({ path: '/details/001', query: { kind: "car" }})

									this.$router.push({ name: 'details', params: { id: '001' }, query: { kind: 'car' }})

组件获取数据

组件通过 $route.query 获取：

				?

									const Details = {

									 template: '<div>Details {{ $route.query.kind }} </div>',

									 created() {

									  // 监听路由变化

									  this.$watch(

									   () => this.$route.query,

									   (toParams, previousParams) => {

									    // 对路由变化做出响应...

									   }

									  )

									 },

									}

要对同一个组件中参数的变化做出响应的话，你可以简单地 watch $route 对象上的任意属性，在这个场景中，就是 $route.query 。

3. 通过 hash 传递

通过此方式，url 路径中带有 hash ，例如： /details/001#car 。

路由配置

使用 hash 时，以下三种方式都是可行的（同 query ）：

				?

									this.$router.push('/details/001#car')

									this.$router.push({ path: '/details/001', hash: '#car'})

									this.$router.push({ name: 'details', params: { id: '001' }, hash: 'car'})

组件获取数据

组件通过 $route.hash.slice(1) 获取：

				?

									const Details = {

									 template: '<div>Details {{ $route.hash.slice(1) }} </div>',

									}

通过 props 进行传递

在组件中使用 $route 会与路由紧密耦合，这限制了组件的灵活性，因为它只能用于特定的 URL。虽然这不一定是件坏事，但我们可以通过 props 配置来解除这种行为。

以解耦的方式使用 props 进行参数传递，主要是在路由配置中进行操作。

1. 布尔模式

当 props 设置为 true 时， route.params 将被设置为组件的 props。

例如下面的代码是通过 $route 的方式获取动态字段 id ：

				?

									const User = {

									 template: '<div>User {{ $route.params.id }}</div>'

									}

									const routes = [{ path: '/user/:id', component: User }]

将上面的代码替换成 props 的形式，如下：

				?

									const User = {

									 props: ['id'], // 组件中通过 props 获取 id

									 template: '<div>User {{ id }}</div>'

									}

									// 路由配置中，增加 props 字段，并将值 设置为 true

									const routes = [{ path: '/user/:id', component: User, props: true }]

注意：对于有命名视图的路由，你必须为每个命名视图定义 props 配置：

				?

									const routes = [

									 {

									  path: '/user/:id',

									  components: { default: User, sidebar: Sidebar },

									  // 为 User 提供 props

									  props: { default: true, sidebar: false }

									 }

									]

2. 对象模式

当 props 是一个对象时，它将原样设置为组件 props。当 props 是静态的时候很有用。

路由配置

				?

									const routes = [

									 {

									  path: '/hello',

									  component: Hello,

									  props: { name: 'World' }

									 }

									]

组件中获取数据

				?

									const Hello = {

									 props: {

									  name: {

									   type: String,

									   default: 'Vue'

									  }

									 },

									 template: '<div> Hello {{ name }}</div>'

									}

<Hello /> 组件默认显示 Hello Vue，但路由配置了 props 对象，当路由跳转到 /hello 时，会显示传递过来的 name ，页面会显示为 Hello World。

3. 函数模式

可以创建一个返回 props 的函数。这允许你将参数转换为其他类型，将静态值与基于路由的值相结合等等。

路由配置

使用函数模式时，返回 props 的函数接受的参数为路由记录 route 。

				?

									// 创建一个返回 props 的函数

									const dynamicPropsFn = (route) => {

									 return { name: route.query.say + "!" }

									}

									const routes = [

									 {

									  path: '/hello',

									  component: Hello,

									  props: dynamicPropsFn

									 }

									]

组件获取数据

当 URL 为 /hello?say=World 时，将传递 {name: 'World!'} 作为 props 传给 Hello 组件。

				?

									const Hello = {

									 props: {

									  name: {

									   type: String,

									   default: 'Vue'

									  }

									 },

									 template: '<div> Hello {{ name }}</div>'

									}