# 编程式导航
注意
v2.0.0 开始,默认对uni导航api触发的页面跳转同插件api跳转效果一致
# router.push() 等同于
uni.navigateTo()
注意:在 Vue 实例内部,你可以通过 $Router 访问路由实例。因此你可以调用 this.$Router.push。
想要导航到不同的 URL,则使用 router.push
方法。这个方法会向 history 栈添加一个新的记录,所以,当用户点击浏览器后退按钮时,则回到之前的 URL。
该方法的参数可以是一个字符串路径,或者一个描述地址的对象。例如:
// 字符串
this.$Router.push('/pages/router/router1')
// 对象
this.$Router.push({path:'/pages/router/router1'})
// 命名的路由
this.$Router.push({ name: 'router1', params: { userId: '123' }})
// 带查询参数,变成 /router1?plan=private
this.$Router.push({ path: 'router1', query: { plan: 'private' }})
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
注意:如果提供了 path,params 会被忽略,上述例子中的 query 并不属于这种情况。所以字符串时必须是绝对的路径,name 时传递的参数必须为 params,相反 path 必须对应 query。
const userId = '123'
this.$Router.push({ name: 'user', params: { userId }}) // -> /user/123
// 这里的 params 不生效
this.$Router.push({ path: '/user', params: { userId }}) // -> /user
1
2
3
4
2
3
4
# router.replace() 等同于
uni.redirectTo()
跟 router.push
很像,唯一的不同就是,它不会向 history 添加新记录,而是跟它的方法名一样 —— 替换掉当前的 history 记录。
this.$Router.replace(...)
1
# router.replaceAll() 等同于
uni.reLaunch()
跟 router.replace
很像,唯一的不同就是,它不会向 history 添加新记录,而是将所有的页面都关掉,打开一个新的页面。
this.$Router.replaceAll(...)
1
# router.pushTab() 等同于
uni.switchTab()
跟 router.push
很像,打开 uni-app
自带的tab 菜单
this.$Router.pushTab(...)
1
# router.back(n,{...}) 等同于
uni.navigateBack()
这个方法的参数是一个正整数,意思是在 history 记录中后退多少步,类似 window.history.go(n)
。
例子
// 后退 2 步记录
this.$Router.back(2,{
success:(...arg)=>{
console.log(arg)
}
})
// 如果 history 记录不够用,那就默默地失败呗
this.$Router.back(100,{
success:(...arg)=>{
console.log(arg)
}
})
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13