位置: IT常识 - 正文

uni-simple-router(uni-simple-router 跳转无效)

编辑：rootadmin

uni-simple-router 专为uniapp打造的路由器，和uniapp深度集成通配小程序、App和H5端 H5能完全使用vue-router开发模块化、查询、通配符、路由参数使 uni-app实现嵌套路由（仅H5端完全使用vue-router） uniapp用到了很多vue的api， ... 目录uni-simple-router一、快速上手

扩一：webpack插件之DefinePlugin扩二：uni-read-pages 如何获取pages.json中的路由二、H5模式

2.1 路由配置2.2 完全使用vue-router开发（H5端）2.3 H5 路由传参2.4 H5端路由捕获所有路由或404路由2.5 路由懒加载三、小程序模式四、路由跳转

4.1 组件跳转4.2 编程式导航五、跨平台模式

5.1 提前享用生命周期5.2 导航守卫六、路由守卫-模块化

扩三、require.context用法uni-simple-router专为uniapp打造的路由器，和uniapp深度集成通配小程序、App和H5端H5能完全使用vue-router开发模块化、查询、通配符、路由参数使 uni-app实现嵌套路由（仅H5端完全使用vue-router）uniapp用到了很多vue的api，但在路由管理的功能相对于vue-router还是比较欠缺的，比如全局导航守卫

推荐整理分享uni-simple-router(uni-simple-router 跳转无效)，希望有所帮助，仅作参考，欢迎阅读内容。

文章相关热门搜索词:uni-simple-router 小程序,uni-simple-router vue3,uni-simple-router vue3,uni-simple-router 不支持vue3,uni-simple-router 不支持vue3,uni-simple-router 小程序,uni-simple-router 回参,uni-simple-router vue3,内容如对您有帮助，希望把文章链接给更多的朋友！

官方文档：https://hhyang.cn/v2/start/quickstart.html

一、快速上手// 针对uniapp HBuilder创建的项目，非cli构建// 1⃣ NPM 安装npm install uni-simple-router// 2⃣ 初始化npm install uni-read-pages // 配合vue.config.js自动读取pages.json作为路由表的方式，源码例如下：扩二// 配置vue.config.jsconst TransformPages = require('uni-read-pages')const tfPages = new TransformPages()module.exports = {configureWebpack: {plugins: [ new tfPages.webpack.DefinePlugin({ // 1⃣ 配置全局变量 // ROUTES: JSON.stringify(tfPages.routes) // 2⃣ includes 可自定义，解析pages.json路由配字段的配置，默认 ['path', 'name', 'aliasPath'] ROUTES: tfPages.webpack.DefinePlugin.runtimeValue(()=>{ const tf = new TransformPages({ includes: ['path', 'name', 'aliasPath'] }) return JSON.stringify(tfPages.routes) },true) })]}}// /Applications/HBuilderX.app/Contents/HBuilderX/plugins/uniapp-cli/node_modules/webpack 我的webpack包路径，在软件contents包文件里软件自带的webpack扩一：webpack插件之DefinePlugin允许创建一个在编译时可以配置的全局变量场景：区分不同开发模式处理// 1⃣ 用法：每个传进DefinePlugin的键值都是一个标志或者多个用.连接起来的标识符new webpack.DefinePlugin({ PRODUCTION: JSON.stringify(true), BROWSER_SUPPRTS_HTML5: true, VERSION: JSON.stringify('abcde'), TWO: '1+1', 'typeof window': JSON.stringify('object')})// 使用方式console.log('Running App version', VERSION)if(!BROWSER_SUPPRTS_HTML5) require("html5shiv")// 2⃣ 功能标记来作为一个flag标识启用和禁用构建中的功能new webpack.DefinePlugin({ 'SHOW_PRESSION': JOSN.string(true)})// 3⃣ 服务：可以配置不同环境下的urlnew webpack.DefinePlugin({ 'DEV_URL': JSON.stringify(url_dev), 'PRO_URL': JSON.stringify(url_pro)})扩二：uni-read-pages 如何获取pages.json中的路由// 依赖的源码 - 通过node的path模块获取pages.json文件中的任何信息 (部分是个人注释)const path = require('path')const CONFIG = { includes: ['path', 'aliasPath', 'name'] } // 默认获取路由参数属性// process.cwd() 返回Node.js进程的当前工作目录// path.resolve(url1, 'abc') => url1/abcconst rootPath = path.resolve(process.cwd(), 'node_modules'); // 获取根路径/** 解析绝对路径 * @param {Object} dir */function resolvePath(dir) {return path.resolve(rootPath, dir);}// 类class TransformPages {constructor(config) { // 组合自定义获取配置属性config = { ...CONFIG, ...config }; this.CONFIG = config; // ↓本机文件路径（HBuilderX包文件里自带的webpack模块路径） /Applications/HBuilderX.app/Contents/HBuilderX/plugins/uniapp-cli/node_modules/webpackthis.webpack = require(resolvePath('webpack'));this.uniPagesJSON = require(resolvePath('@dcloudio/uni-cli-shared/lib/pages.js')); // TODO: 根据CONFIG解析pages.json中的路由信息和小程序分包下的路由this.routes = this.getPagesRoutes().concat(this.getNotMpRoutes());} // 获取所有pages.json下的内容返回jsonget pagesJson() {return this.uniPagesJSON.getPagesJson();} // 通过读取pages.json文件生成直接可用的routesgetPagesRoutes(pages = this.pagesJson.pages, rootPath = null) {const routes = [];for (let i = 0; i < pages.length; i++) {const item = pages[i];const route = {};for (let j = 0; j < this.CONFIG.includes.length; j++) {const key = this.CONFIG.includes[j];let value = item[key];if (key === 'path') {value = rootPath ? `/${rootPath}/${value}` : `/${value}`}if (key === 'aliasPath' && i == 0 && rootPath == null) {route[key] = route[key] || '/'} else if (value !== undefined) {route[key] = value;}}routes.push(route);}return routes;}// 解析小程序分包路径getNotMpRoutes() {const { subPackages } = this.pagesJson;let routes = [];if (subPackages == null || subPackages.length == 0) {return [];}for (let i = 0; i < subPackages.length; i++) {const subPages = subPackages[i].pages;const root = subPackages[i].root;const subRoutes = this.getPagesRoutes(subPages, root);routes = routes.concat(subRoutes)}return routes}/** * 单条page对象解析 * @param {Object} pageCallback * @param {Object} subPageCallback */parsePages(pageCallback, subPageCallback) {this.uniPagesJSON.parsePages(this.pagesJson, pageCallback, subPageCallback)}}module.exports = TransformPages二、H5模式2.1 路由配置import {RouterMount,createRouter} from 'uni-simple-router';const router = createRouter({ // 路由配置 routes: [ { path: '/pages/index/index', // 必须和pages.json中相同 extra: { pageStyle: { color: '#f00' }// 及其它自定义参数 } } ]})// 组件中可以通过 this.$Route 查看路由元信息2.2 完全使用vue-router开发（H5端）嵌套路由时，若使用name方式跳转，仅支持 this.$router.push({ name: children1 })// 使用 vue-router开发将会失去uniapp的生命周期const router = createRouter({ h5: { vueRouterDev: true, // 完全使用vue-router开发默认是false }, // 路由配置 routes: [ { path: '/', name: 'home', component: () => import('@/common/router/home.vue'), // 嵌套路由（仅H5端），小程序端会重新页面打开 children: [ { path: 'home/children1', name: 'children1', component: () => import('@/common/router/children1.vue') }, { path: 'home/children2', name: 'children2', component: () => import('@/common/router/children2.vue') } ] } ]})2.3 H5 路由传参// 除vue-router外，美化url可以在基础配置时，定义aliasPath变量，设置路由别名（浏览器地址栏展示名称）// 别名的设置，如果设置了别名，通过push路径的方式，必须使用aliasPath的路径才能生效const router = createRouter({ routes:[{ name:'router1', //为了兼容其他端，此时的path不能少，必须和 pages.json中的页面路径匹配 path: "/pages/tabbar/tabbar-1/tabbar-1", aliasPath: '/tabbar-1', },]});// uni-simple-router路由跳转// aliasPath命名的路由 => name传递参数需 paramsthis.$Router.push({ name: 'detail', params: { id: 1 } })// 带查询参数，变成 /home/id=1 => path 对应query，params失效this.$Router.push({ path: '/pages/index/detail', query: { id: 1 }})2.4 H5端路由捕获所有路由或404路由path：'*' // 通常用于客户端404错误，如果是history模式，需要正确配置服务器path: '/detail-*'// 路由的优先级根据定义的先后2.5 路由懒加载

打包构建应用时，Javascript包会变得非常大，影响页面加载，把不同路由对应的组件分割成不同的代码块，然后当路由被访问的时候才加载对应组件。

const Foo = () => import('./Foo.vue') // 把组件按组分块使用命名 chunk const Foo = () => import(/*webpackChunkName:"group-foo"*/ './Foo.vue') const Bar = () => import(/*webpackChunkName:"group-foo"*/ './Bar.vue')三、小程序模式