详解react-router如何实现按需加载
注:本文使用的 react-router 版本为 2.8.1
react router 是一个非常出色的路由解决方案,同时也非常容易上手。但是当网站规模越来越大的时候,首先出现的问题是 javascript 文件变得巨大,这导致首页渲染的时间让人难以忍受。实际上程序应当只加载当前渲染页所需的 javascript,也就是大家说的“代码分拆" — 将所有的代码分拆成多个小包,在用户浏览过程中按需加载。
所得到的效果是:
以前是这样(23333,我真不是故意的。。)
现在是这样:
实际上就是将一个大 javascript 文件拆分成了若干个 chunk file。
下面是改造过程
webpack 配置
首先在 webpack.config.js
的 output
内加上 chunkfilename
output: { path: path.join(__dirname, '/../dist/assets'), filename: 'app.js', publicpath: defaultsettings.publicpath, // 添加 chunkfilename chunkfilename: '[name].[chunkhash:5].chunk.js', },
name
是在代码里为创建的 chunk 指定的名字,如果代码中没指定则 webpack 默认分配 id 作为 name。
chunkhash
是文件的 hash 码,这里只使用前五位。
添加首页
以前你的路由大概应该是这样的:(作为需要按需加载的大型应用,路由肯定是相当复杂,这里只列举部分路由举例)
reactdom.render( ( <router history={browserhistory}> {/* 主页 */} <route path="/" component={app}> {/* 默认 */} <indexroute component={homepage} /> {/* baidu */} <route path="/baidu" component={baidupage}> <route path="result" component={baiduresultpage} /> <route path="frequency" component={baidufrequencypage} /> </route> {/* 404 */} <route path='/404' component={notfoundpage} /> {/* 其他重定向到 404 */} <redirect from='*' to='/404' /> </route> </router> ), document.getelementbyid('app') );
按需加载之后,我们需要让路由动态加载组件,需要将 component
换成 getcomponent
。首先将路由拆出来(因为路由庞大之后全部写在一起会很难看),创建一个根路由 rootroute:
const rootroute = { path: '/', indexroute: { getcomponent(nextstate, cb) { require.ensure([], (require) => { cb(null, require('components/layer/homepage')) }, 'homepage') }, }, getcomponent(nextstate, cb) { require.ensure([], (require) => { cb(null, require('components/main')) }, 'main') }, childroutes: [ require('./routes/baidu'), require('./routes/404'), require('./routes/redirect') ] } reactdom.render( ( <router history={browserhistory} routes={rootroute} /> ), document.getelementbyid('app') );
history 不变,在 router 中添加 routes 属性,将创建的路由传递进去。
这里有四个属性:
path
将匹配的路由,也就是以前的 path。
getcomponent
对应于以前的 component 属性,但是这个方法是异步的,也就是当路由匹配时,才会调用这个方法。
这里面有个 require.ensure 方法
require.ensure(dependencies, callback, chunkname)
这是 webpack 提供的方法,这也是按需加载的核心方法。第一个参数是依赖,第二个是回调函数,第三个就是上面提到的 chunkname,用来指定这个 chunk file 的 name。
如果需要返回多个子组件,则使用 getcomponents 方法,将多个组件作为一个对象的属性通过 cb 返回出去即可。这个在官方示例也有,但是我们这里并不需要,而且根组件是不能返回多个子组件的,所以使用 getcomponent。
indexroute
用来设置主页,对应于以前的 <indexroute>。
注意这里的 indexroute 写法, 这是个对象,在对象里面使用 getcomponent。
childroutes
这里面放置的就是子路由的配置,对应于以前的子路由们。我们将以前的 /baidu、/404 和 * 都拆了出来,接下来将分别为他们创建路由配置。
路由控制
上面的childroutes
里面,我们 require
了三个子路由,在目录下创建 routes
目录,将这三个路由放置进去。
routes/ ├── 404 │ └── index.js ├── baidu │ ├── index.js │ └── routes │ ├── frequency │ │ └── index.js │ └── result │ └── index.js └── redirect └── index.js
和 rootroute 类似,里面的每个 index.js 都是一个路由对象:
/404/index.js
module.exports = { path: '404', getcomponent(nextstate, cb) { require.ensure([], (require) => { cb(null, require('components/layer/notfoundpage')) }, 'notfoundpage') } }
/baidu/index.js
module.exports = { path: 'baidu', getchildroutes(partialnextstate, cb) { require.ensure([], (require) => { cb(null, [ require('./routes/result'), require('./routes/frequency') ]) }) }, getcomponent(nextstate, cb) { require.ensure([], (require) => { cb(null, require('components/layer/baidupage')) }, 'baidupage') } }
/baidu/routes/frequency/index.js
module.exports = { path: 'frequency', getcomponent(nextstate, cb) { require.ensure([], (require) => { cb(null, require('components/layer/baidufrequencypage')) }, 'baidufrequencypage') } }
举这几个例子应该就差不多了,其他都是一样的,稍微有点特别的是 redirect。
设置 redirect
之前我们在根路由下是这么设置重定向的:
<router history={browserhistory}> <route path="/" component={app}> {/* home */} <indexroute component={homepage} /> <route path="/baidu" component={baidupage}> <route path="result" component={baiduresultpage} /> <route path="frequency" component={baidufrequencypage} /> </route> <route path='/404' component={notfoundpage} /> {/* 如果都不匹配,重定向到 404 */} <redirect from='*' to='/404' /> </route> </router>
当改写之后,我们需要把这个重定向的路由单独拆出来,也就是 * 这个路由,我们上面已经为他创建了一个 redirect 目录。这里使用到 onenter 方法,然后在这个方法里改变路由状态,调到另外的路由,实现 redirect :
/redirect/index.js
module.exports = { path: '*', onenter: (_, replacestate) => replacestate(null, "/404") }
the root route must render a single element
跟着官方示例和上面码出来之后,可能页面并没有渲染出来,而是报 the root route must render a single element 这个异常,这是因为 module.exports
和 es6 里的 export default
有区别。
如果你是使用 es6 的写法,也就是你的组件都是通过 export default 导出的,那么在 getcomponent 方法里面需要加入 .default。
getcomponent(nextstate, cb) { require.ensure([], (require) => { // 在后面加 .default cb(null, require('components/layer/reportpage')).default }, 'reportpage') }
如果你是使用 commonjs 的写法,也就是通过 module.exports
导出的,那就无须加 .default
了。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
上一篇: JavaScript对象_动力节点Java学院整理
下一篇: 微信小程序时间选择插件使用详解