官方文档：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// 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)})// 依赖的源码 - 通过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/webpack this.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下的内容 返回json get pagesJson() { return this.uniPagesJSON.getPagesJson(); } // 通过读取pages.json文件 生成直接可用的routes getPagesRoutes(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 = TransformPagesimport {RouterMount,createRouter} from 'uni-simple-router';const router = createRouter({ // 路由配置 routes: [ { path: '/pages/index/index', // 必须和pages.json中相同 extra: { pageStyle: { color: '#f00' }// 及其它自定义参数 } } ]})// 组件中可以通过 this.$Route 查看路由元信息// 使用 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') } ] } ]})// 除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 }})path：'*' // 通常用于客户端404错误，如果是history模式，需要正确配置服务器path: '/detail-*'// 路由的优先级根据 定义的先后打包构建应用时，Javascript包会变得非常大，影响页面加载，把不同路由对应的组件分割成不同的代码块，然后当路由被访问的时候才加载对应组件。
const Foo = () => import('./Foo.vue') // 把组件按组分块 使用 命名 chunk const Foo = () => import(/*webpackChunkName:"group-foo"*/ './Foo.vue') const Bar = () => import(/*webpackChunkName:"group-foo"*/ './Bar.vue')注：小程序系列无法拦截原生tabbar及原生导航返回，如需拦截使用自定义tabbar、header
通过api进行切换时，像uni.switchTab()和this.$Router.pushTab()方法会触发拦截的；仅底部原生tabbar进行切换时不触发拦截
强制触发守卫：forceGuardEach(replaceAll, false) 每次调用api都会重新按流程触发已经声明的所有守卫
跳转路由锁：animationDuration保留给redirection\push足够时间，等切换完成页面后才放行下次跳转
const router = createRouter({ platform: process.env.VUE_APP_PLATFORM, // ① 路由锁 applet: { animationDuration: 300 // 默认300ms // animationDuration: 0 // 不精准 只捕捉跳转api下的complete函数 }, // ②优雅解锁 error.type: 0 表示 next(false)、1表示next(unknownType)、2表示加锁状态，禁止跳转、3表示在获取页面栈时，页面栈不够level获取 routerErrorEach:(error, router) => { if (error.type === 3) { router.$lockStatus = false } }, routes: [...ROUTES]})vue-router中可以通过router-link组件进行页面跳转，uni-simple-router也提供了类似的组件，需要手动注册
// main.js import Link from './node_modules/uni-simple-router/dist/link.vue' Vue.component('Link', Link) // 通过path直接跳转 并指定跳转类型 <Link to="/tabbar1" navType="pushTab"> <button type="primary">使用path对象跳转</button> </Link>uniapp由于只用onLoad接受options参数、onShow不接受；传递深度对象参数时，需要先编码再传递解码
// 动态改变参数 使 onLoad和onShow支持options const router = createRouter({ platform: process.env.VUE_APP_PLATFORM, routes: [...ROUTES], beforeProxyHooks: { onLoad(options, next){ next([router.currentRoute.query]); }, onShow([options], next){ console.log(this); const args=options||router.currentRoute.query; next([args]); }, }, });全局前置守卫
/*** to: Route 即将进入的目标* from: Route 当前导航正要离开的路由* next: Function 该方法的resolve钩子函数必须调用，执行效果依赖next方法的调用参数* -- next()调用参数：管道中的下个钩子； next(false)中断当前导航；* -- next('/')/({path: '/'})跳转到一个不同的地址。当前的导航被中断，然后进行一个新的导航* -- next({delta: 2, NAVTYPE: 'back'}) 中断当前导航，调用新的跳转类型，同时返回两层页面**/router.beforeEach((to, from, next) => { // ... // 1? next() // 2? NAVTYPE定义跳转方式，两者相同非必填 if (to.name == 'tabbar-5') { next({ name: 'router4', params: { msg: '我拦截了tab5并重定向到了路由4页面上', }, NAVTYPE: 'push' }); } else{ next(); }})全局后置守卫
// 不接受next函数也不改变导航本身router.afterEach((to,from) => {})路由独享守卫
// 路由配置上直接定义beforeEnter守卫const router = createRouter({ routes: [{ path: '/pages/home/index', beforeEnter:(to,from,next) => { // 参数同上全局前置守卫 next() } }]})组件内的守卫
// 组件内配置beforeRouteLeave守卫 - 直接调用beforeRouteLeave方法export default { beforeRouteLeave(to, from, next) { // 导航离开该组件的对应路由时调用 // 可以访问组件实例this next() }}// 1? 创建 router文件夹，模块化配置 文件结构|+------------------------+|| router || |+--------------------+| || | modules | || | |+----------------+| | || | | home.js | | || | | index.js | | || | |+----------------+| | || |+--------------------+| || index.js ||+------------------------+|// home.jsconst home = [ { path: '/pages/home/index', name: 'home' }]export default home// modules下的index.js是一个模块读取// ① require.context(directory, useSubdirectories, regExp) 具体详情：如下扩三const files = require.contxt('.',false,/.js$/)const modules = []files.keys().froEach(key => { if (key === './index.js') return const item = files(key).default modules.push(...item)})export default modules // 将所有模块的路由模块整合到一起， routes Array// router下的index.js 路由守卫import modules from './modules/index.js'import Vue from 'vue'import CreateRouter from 'uni-simple-router'import store from '@/store/store.js'Vue.use(CreateRouter)//初始化const router = new CreateRouter({ APP: { holdTabbar: false //默认true }, h5: { vueRouterDev: true, //完全使用vue-router开发 默认 false }, // 也可以 通过uni-read-pages来读取pages.json文件的路由表，配合vue.config.js // router: [...ROUTES] // ROUTES是通过webpack的defaultPlugin编译成全局变量，具体操作上文 routes: [...modules] //路由表});//全局路由前置守卫router.beforeEach((to, from, next) => { // 首先判断是否存在路由信息 //不存在就先调用接口得到数据})// 全局路由后置守卫router.afterEach((to, from) => {})export default router;// require.context(directory, useSubdirectories, regExp)// directory: 表示检索的目录// useSubdirectories: 表示是否检索子文件夹// regExp: 匹配文件的正则表达式// 返回值： resolve是一个函数，返回已解析请求的模块ID； keys是一个函数，它返回上下文模块可以处理的所有可能请求的数组；// 使用场景：①用来组件内引入多个组件；②在main.js内引入大量公共组件；// ①组件内引入多个组件 - webpackconst path = require('path')const files = require.context('@/components/home', false, /\.vue$/) //值类型 ['./home.js', 'detail.js',...]const modules = {}files.keys().forEach(key => { const name = paths.basename(key, '.vue') // 去掉文件名的 .vue后缀 modules[name] = files(key).default || files(key)})// modules { home: '{module样式路径}', detail: '{}', ... }export default { ..., data() { return {}}, components: modules}// ②在main.js内引入大量公共组件import Vue from 'vue'// 引入自定义组件const requireComponents = require.context('../views/components',true,'/\.vue/')// 遍历出每个数组的路径requireComponents.keys().forEach(fileName => { const reqCom = requireComponents(fileName) // 获取组件名 const reqComName = reqCom.name || fileName.replace(/\.\/(.*)\.vue/, '$1') // 组件挂载 Vue.components(reqComName, reqCom.default || reqCom)})