uniapp-router-patch

在 uni-app 生成的小程序中 vue-router的兼容写法 基于 mpvue-router-pacth

使用

// main.js
import Vue from 'vue'
import UniappRouterPatch from 'uniapp-router-patch'

Vue.use(UniappRouterPatch)

安装

npm install uniapp-router-patch

API

支持以下列出的方法及属性

Router 实例

属性

• $router.app

当前页面的 Vue 实例

• $router.mode

路由使用的模式，固定值 history

• $router.currentRoute

当前路由对应的路由信息对象，等价于 $route

方法

• $router.push(location, onComplete?, onAbort?, onSuccess?)

跳转到应用内的某个页面，uni.navigateTo、uni.switchTab 及 uni.reLaunch 均通过该方法实现，location 参数支持字符串及对象两种形式，跳转至 tabBar 页面或重启至某页面时必须以对象形式传入

// 字符串
router.push('/pages/news/detail')

// 对象
router.push({ path: '/pages/news/detail' })

// 带查询参数，变成 /pages/news/detail?id=1
router.push({ path: '/pages/news/detail', query: { id: 1 } })

// 切换至 tabBar 页面
router.push({ path: '/pages/news/list', isTab: true })

// 重启至某页面，无需指定是否为 tabBar 页面，但 tabBar 页面无法携带参数
router.push({ path: '/pages/news/list', reLaunch: true })

• $router.replace(location, onComplete?, onAbort?, onSuccess?)

关闭当前页面，跳转到应用内的某个页面，相当于 uni.redirectTo，location 参数格式与 $router.push 相似，不支持 isTab 及 reLaunch 属性

• $router.go(n)

关闭当前页面，返回上一页面或多级页面，n 为回退层数，默认值为 1

• $router.back()

关闭当前页面，返回上一页面

路由信息对象

属性

• $route.path

字符串，对应当前路由的路径，总是解析为绝对路径，如 /pages/news/list

• $route.params

空对象，小程序不支持该属性

• $route.query

一个 key/value 对象，表示 URL 查询参数。例如，对于路径 /pages/news/detail?id=1，则有 $route.query.id == 1，如果没有查询参数，则是个空对象。

• $route.hash

空字符串，小程序不支持该属性

• $route.fullPath

完成解析后的 URL，包含查询参数和 hash 的完整路径

• $route.name

当前路由的名称，由 path 转化而来