README
原源代码为 https://github.com/xdoer/generated-plugin-taro-router-service 我做了些生成优化修改,
- 常量字符串只有一份的原则,生成到taroPages.js中,
- 不再修改app.config.ts,而用引用taroPages.js
- 不限定pageName为index,可以用正则过滤匹配
- 对pageName增加排除配置
- 增加首页配置功能
- 对subPackage增加文件夹过滤,而不是只限到到package-*中,当pages中的文件要分包,不需要移动,直接配置在subPageDirs中
- 因为生成代码不同,无法与原来的兼容,以所以重新起个名称,
taro-auto-router-plugin
让你的 Taro 路由跳转拥有类似 umi 框架约定式路由的体验。
简介
Taro 中内置了路由功能,这极大的方便了开发者。我们开发一个小程序页面时,流程是这样的。
- 新建页面文件
- app.config.ts 配置页面路径
使用时,需要在方法里书写完整页面路径。
navigateTo({ url: '/package-test/pages/test/index?id=1' })
比较好的开发方式应当是将所有页面路径维护到一个单独的路径映射表中。
navigateTo({ url: `${URLs.Test}?id=1` })
但这样的话,虽然方便了调用,但又需要多维护一份路由映射表文件。
因而这个脚本诞生了。
作用
自动配置,不修改该文件,而用采用依赖倒置引用taroPages.jsapp.config.ts
文件进行页面注册自动配置project.config.json
文件,添加开发者工具页面编译快捷入口- 自动生成
taroPages.js
文件,由于taro编译app.config.ts没有经过webpack编译,该js文件支持require引用- 自动生成
routerService.ts
文件,使得路由调用跳转更便捷。和之前生成不同,这里采用依赖倒置原则,常理化,便于在代码更灵活调用- 配合webpack-plugin-chokidar插件,新建页面文件后,将自动运行脚本,生成各项配置。
//taroPages.js 兼容app.config.ts中引用: const { pages, subPackages } = require('./service/taroPages')
const pages_test_index = "package-test/pages/test/index"
...
const index_index = "pages/index/index"
const firstPage_FirstPage = "pages/firstPage/FirstPage"
const pages = [
index_index,
firstPage_FirstPage,
]
const subPackages = [
{
"name": "pages_subPackage",
"root": "pages/subPackage/",
"pages": [
"nest/index",
"test/index"
]
}...]
module.exports = {
pages_test_index,
...
firstPage_FirstPage,
pages,
subPackages,
}
routerService.ts引用taroPages.js
import { navigateTo } from "@common/utils"
import taroPages from "./taroPages"
export namespace RouterService {
/** package-test/pages/test/index */
export const toPages_test_index = <T>(data?: T, opt?: any) => navigateTo(taroPages.pages_test_index, data as any, opt as any)
...
export const toIndex_index = <T>(data?: T, opt?: any) => navigateTo(taroPages.index_index, data as any, opt as any)
/** pages/firstPage/FirstPage */
export const toFirstPage_FirstPage = <T>(data?: T, opt?: any) => navigateTo(taroPages.firstPage_FirstPage, data as any, opt as any)
}
不再修改app.config.ts
//app.config.ts
import Taro from '@tarojs/taro';
const { pages, subPackages } = require('./service/taroPages')
export default {
//pages,subPackages采用依赖倒置,永远不变
pages: [...RouterService.pages],
subPackages: [
...RouterService.subPackages
],
//...
} as Taro.Config
环境
taro typescript
支持 react, vue
效果
安装
npm i taro-auto-router-plugin -D
使用
经过配置后,使用非常简单,只需要新建页面文件,即可直接进行调用。
<View onClick={() => routerService.toTest({ id: 1 })}>跳转</View>
注意: 嫌配置麻烦的,可直接拷贝 example 代码进行使用
配置
注: 会将 [package-(module)/]pages/(page-name).[tsx|vue] 自动识别为页面
注册插件
1、在根目录新建 generated 配置文件 .generatedrc.ts
2、注册插件
import { GeneratedrcConfig } from 'generated'
const generatedrc: GeneratedrcConfig = {
configDir: './gconfig', // generated 插件配置目录
plugins: [
'taro-auto-router-plugin', // 注册插件
],
}
export default generatedrc
配置插件
1、在根目录新建 gconfig
文件夹,文件夹下新建 router.ts
配置文件.
2、写入配置
import { Config } from 'taro-auto-router-plugin/src/types'
const basePath = process.cwd()
export const taroRouter: Config = {
//注释部分为默认值
// projectPath: process.cwd(),
// srcDir: 'src',
// firstPage: '/index/',
// pagesDir: 'pages',
// exts: ['.tsx', '.jsx', '.vue'],
// pageRegExps: [/^index/i, /page/i],
// pageIgnoreRegExps: [/_x$/i],
projectPath: basePath,
subPageDirs:['package-test','pages/subPackage'],
appConfigPath: basePath + '/src/app.config.ts',
projectConfigPath: basePath + '/project.config.json',
routerServiceFile: 'service/routerService',
navigateFnName: 'navigateTo',
navigateSpecifier: '@common/utils',
}
注意:
- 这里
taroRouter
名称不能变- 配置的函数(navigateFnName)需要满足传参为 customNavigateTo(pagePath: string, data: Object, opt: Object)
配置命令
1、在 package.json
中写入生成命令
"scripts": {
"gen": "generated",
}
2、运行命令即可生成 routerService.ts
文件
npm run gen
路由方法
工具内部没有直接使用 taro 原生的 navigateTo
方法,而是需要手动配置方法。一是因为 taro 导出的路由 API 并不好用,二是 API 封装在内部,自定义程度不够高。您可以在保证函数传参条件的情况下,随意进行函数实现
import { navigateTo } from '@tarojs/taro'
export function customNavigateTo(pagePath: string, data?: any, opt?: any) {
const url = createFinalURL(pagePath, data)
navigateTo({ url, ...opt })
}
监听文件变更自动运行命令
新建文件后,手动运行 generated
命令还是不够方便,因而,我设计了一个集成 chokidar 的 webpack 插件webpack-plugin-chokidar,通过该插件,可以很容易的对文件更改进行监听,然后利用 shelljs 执行脚本即可。
案例
- 本人不会vue,所以vue部分没有相应改动,应该是跑不起来,请参照react修改
- React + Typescript
- Vue3 + Typescript