详解react-router如何实现按需加载

发布时间 - 2026-01-11 01:54:08    点击率:

注:本文使用的 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 了。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。


# reactrouter  # 按需加载  # react  # router按需加载  # router  # 按需  # 关于React动态加载路由处理的相关问题  # React-router 4 按需加载的实现方式及原理详解  # 详解react-router4 异步加载路由两种方法  # react中路由和按需加载的问题  # 多个  # 加载  # 是这样  # 都是  # 重定向  # 你是  # 应于  # 首页  # 这里面  # 的是  # 这是  # 是在  # 让人  # 也有  # 成了  # 都不  # 有个  # 在这个  # 第一个 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 网站图片在线制作软件,怎么在图片上做链接?  Claude怎样写结构化提示词_Claude结构化提示词写法【教程】  ChatGPT 4.0官网入口地址 ChatGPT在线体验官网  潮流网站制作头像软件下载,适合母子的网名有哪些?  详解Android图表 MPAndroidChart折线图  如何制作公司的网站链接,公司想做一个网站,一般需要花多少钱?  PHP 500报错的快速解决方法  Laravel如何与Docker(Sail)协同开发?(环境搭建教程)  C++用Dijkstra(迪杰斯特拉)算法求最短路径  Laravel如何优雅地处理服务层_在Laravel中使用Service层和Repository层  EditPlus中的正则表达式 实战(4)  Win11应用商店下载慢怎么办 Win11更改DNS提速下载【修复】  手机网站制作平台,手机靓号代理商怎么制作属于自己的手机靓号网站?  详解Nginx + Tomcat 反向代理 负载均衡 集群 部署指南  公司网站制作价格怎么算,公司办个官网需要多少钱?  如何快速打造个性化非模板自助建站?  高端建站三要素:定制模板、企业官网与响应式设计优化  Laravel怎么实现软删除SoftDeletes_Laravel模型回收站功能与数据恢复【步骤】  如何自己制作一个网站链接,如何制作一个企业网站,建设网站的基本步骤有哪些?  胶州企业网站制作公司,青岛石头网络科技有限公司怎么样?  html5源代码发行怎么设置权限_访问权限控制方法与实践【指南】  厦门模型网站设计制作公司,厦门航空飞机模型掉色怎么办?  如何在服务器上三步完成建站并提升流量?  高端云建站费用究竟需要多少预算?  Laravel如何使用Gate和Policy进行权限控制_Laravel权限判定与策略规则配置  Laravel全局作用域是什么_Laravel Eloquent Global Scopes应用指南  高防服务器租用首荐平台,企业级优惠套餐快速部署  HTML 中动态设置元素 name 属性的正确语法详解  如何挑选最适合建站的高性能VPS主机?  使用PHP下载CSS文件中的所有图片【几行代码即可实现】  Microsoft Edge如何解决网页加载问题 Edge浏览器加载问题修复  Laravel如何为API生成Swagger或OpenAPI文档  Python数据仓库与ETL构建实战_Airflow调度流程详解  青岛网站建设如何选择本地服务器?  Edge浏览器如何截图和滚动截图_微软Edge网页捕获功能使用教程【技巧】  弹幕视频网站制作教程下载,弹幕视频网站是什么意思?  浅谈redis在项目中的应用  Gemini手机端怎么发图片_Gemini手机端发图方法【步骤】  如何在宝塔面板创建新站点?  如何在VPS电脑上快速搭建网站?  Laravel任务队列怎么用_Laravel Queues异步处理任务提升应用性能  在centOS 7安装mysql 5.7的详细教程  如何用ChatGPT准备面试 模拟面试问答与职场话术练习教程  php结合redis实现高并发下的抢购、秒杀功能的实例  微信小程序 配置文件详细介绍  QQ浏览器网页版登录入口 个人中心在线进入  Midjourney怎么调整光影效果_Midjourney光影调整方法【指南】  香港服务器网站推广:SEO优化与外贸独立站搭建策略  香港服务器网站卡顿?如何解决网络延迟与负载问题?  php静态变量怎么调试_php静态变量作用域调试技巧【解答】