为了追求极致的用户体验,很多Web应用采用单页面方式呈现,然而单页面应用,往往对应着高复杂度,比如多层次路由配置、统一数据处理等,这需要项目有一个强大的技术架构和友好的构建环境来支撑。路由器,作为单页面构建的基础,对单页面应用的开发、加载、运行各个环节都起着至关重要的作用,项目体量越大,对路由器的依赖表现越强。
下面是一个React应用的基础路由配置,了解React的同学一定不陌生:
const App = ()=> {
return (
<HashRouter>
<div>
<Route cache component={ Home } path="/"/>
<Route component={ Products } path="/products"/>
</div>
</HashRouter>
)
}
ReactDOM.render(<App/>, document.getElementById('root'))
是啊,路由配置不就这么简单吗?
真正做过单页面应用的同学要反驳你了,并且会立刻提出很多问题:
- 路由配置拆分怎么做?
- 动态加载怎么做?
- props怎么传递?
- 登录拦截怎么做?
- 列表页能不能缓存?
- balabala…
能遇到这些问题的同学,相信一定是饱经风霜了。这些问题,Demo中是不会有的,都是真实项目中才能遇到的。
当然,这篇文章,就是为解决这些问题而生的,下面我们以React-Keeper(以下简称Keeper)为例,来解决这些问题。
BTW: React-Keeper是React生态里一款较新的开源路由库,由国内团队开发,借鉴了React-Router 4很多特点,不过灵活性、实用性都强于React-Router很多,而且兼容React-Router常用用法,其文档和代码可以参见React-Keeper GitHub官网。
1. 路由拆分
集中化的路由配置是一个很糟糕的方案,尤其是在大型Web应用中,路由拆分是很有必要的。
Keeper实现路由拆分的方式:
const App = ()=> {
return (
<HashRouter>
<div>
<Route cache component={ Home } path="/"/>
<Route component={ Products } path="/products"/>
</div>
</HashRouter>
)
}
const Products = ()=> {
return (
<div>
<Route component={ ScienceProducts } path="/sci" />
<Route component={ DailiUseProducts } path="/dai" />
</div>
)
}
ReactDOM.render(<App/>, document.getElementById(‘root’)) 实际开发中可以将大量的路由配置信息,按照模块化的方式进行拆分,跟路由只引入模块入口,内部页面配置在模块内部,模块内可以再切分二级模块,以此实现路由的拆分。
2. 动态加载
把所有的JS文件打包为一个文件并不是一个明智的选择,这样会严重拖慢首屏的加载时间,JS代码应该是分割的,并且是按需加载的。
Keeper实现按需加载的方式:
// 定义动态加载函数
const loadProduct = (cb)=> {
System.import('../Products.js').then((Products)=>{
cb(Products)
})
}
// 通过loadComponent属性引入
<Route loadComponent={ loadProduct } path='/products'/>
3. props传递
我们知道在React-Router中并不支持自定义props的传递,然而这在Keeper中支持得很好:
let hostUser = { id: 'ASDFSDFG', name: '马化腾' }
// 父组件中通过props传入Route (hostUser)
const Products = ()=> {
return (
<div>
<Route hostUser={ hostUser } component={ ScienceProducts } path="/sci" />
<Route component={ DailiUseProducts } path="/dai" />
</div>
)
}
// Route组件所有的props自动传入子组件
const ScienceProducts = (props)=> {
return (
<div>
<h3>{ props.hostUser.name }</h3>
</div>
)
}
4. 登录拦截
登录拦截、权限检测、表单关闭检测,这些是业务中非常常见的场景,而这也在Keeper中得到了很好的支持。
Keeper提供了两种过滤器来对路由的状态变化进行过滤和拦截:EnterFilter和LeaveFilter。
EnterFilter: 进入页面之前执行的过滤器,适用于登录检测、权限检测一类的场景。
LeaveFilter: 页面解绑之前执行的过滤器,适用于表单关闭检测一类的场景。
// 定义过滤器,内部通过callback进行流程控制
const loginFilter = (callback, props)=> {
if(!props.host) {
new Promise((resolve, reject)=>{
// some code
}).then(callback);
}
}
// 将过滤器加入Route
<HashRouter>
<Route path='/user' component={User} enterFilter={ loginFilter } />
</HashRouter>
// 多过滤器配置
<HashRouter>
<Route path='/user' component={User}, enterFilter={[ loginFilter, permitFilter1, permitFilter2 ] } />
</HashRouter>
5. 进阶
Keeper提供了很灵活的配置方式,以让我们简单的写出优雅的代码。从下面看几个场景切入介绍下Keeper常用配置的使用。
Q1: 页面未找到时显示默认
A1: 使用Route提供的miss属性,当页面找不到的时候自动渲染该组件。
<Route miss path='/home' component={ Home }/>
Q2: 进入一个模块直接进入模块引导页
A2: 使用Route提供的index属性,和miss使用方式雷同,并且可以和miss一起使用。
<Route index miss path='/home' component={ Home }/>
Q3: 组件地址重定向的处理
A3: 使用Route提供的redirect属性,当其他条件匹配完成时,自动进行页面重定向。
<Route redirect='/homepage' path='/home' component={ Home }/>
Q4: 如何使用history的state属性?
A4: Keeper内部集成了state代理,对支持state API的浏览器,直接使用state API;对其他浏览器使用内部集成的state管理器,即使用随机ID(URL中加入随机key)来映射state,并使用sessionStorage进行存储。
写在最后
React-Keeper是一款新兴的React路由库,由于其灵活的设计和强大的实用功能,一经发布便引起众多React开发者关注与尝试。
React-Keeper刚刚发布了V2.0版本,在底层很多地方做了优化。不过新兴框架,文档还不健全,目前开发者的使用方式,都是依赖其GitHub官网文档,目前尚未有中文文档。
一句话点评React-Keeper: 学习自React-Router,却远超过React-Router。
附录
React-Keeper Github : https://github.com/vifird/react-keeper 原文地址 : https://zhuanlan.zhihu.com/p/26308250