我们在开发单页面应用时,有时需要进入某个路由后基于参数从服务器获取数据,那么我们首先要获取路由传递过来的参数,从而完成服务器请求,所以,我们需要了解路由传参的几种方式,以下方式同 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>'
}
此时页面将渲染:Hello World!
注意:请尽可能保持 props
函数为无状态的,因为它只会在路由发生变化时起作用。如果你需要状态来定义 props,请使用包装组件,这样 vue 才可以对状态变化做出反应。
其他方式
1. 通过 Vuex 进行传递
1. store 存储状态;
2. A 组件更改 store 中的状态;
3. B 组件从 store 中获取。
2. 通过前端本地存储等方式
1. Local Storage;
2. Session Storage;
3. IndexedDB;
4. Web SQL;
5. Cookies。