React Router 按需加载+服务器渲染的闪屏问题

伴随着React协议的『妥协』(v16采用MIT),React为项目的主体,这个在短期内是不会改变的了,在平时使用过程中发现了如下这个问题:

在服务器渲染的时候,刷新页面会出现闪屏的现象(白屏一闪而过)

作为努力最求极致的我,是不能容忍的,而这一现象是半道出现的,也就是在添加按需加载之后。要说清楚这个问题,得从React的服务器渲染开始说起,(急于寻求问题解决方案的,可以直接去文章后半部分)

服务器渲染(SSR)基础原理

React的虚拟DOM是其可被用于服务端渲染的关键。其原理简单的来说就是首先每个ReactComponent 在虚拟DOM中完成渲染,然后React通过虚拟DOM来更新浏览器DOM中产生变化的那一部分。虚拟DOM作为内存中的DOM表现,为React在Node.js这类非浏览器环境下提供了可能。React可以从虚拟DOM中生成一个字符串,而不是更新真正的DOM,这使得我们可以在客户端和服务端使用同一个React Component。

基本设计理念

React 提供了两个可用于服务端渲染组件的函数:ReactDOMServer.renderToStringReactDOMServer.renderToStaticMarkup。 在设计用于服务端渲染的ReactComponent时需要有预见性,考虑以下方面:

  • 选取最优的渲染函数。
  • 如何支持组件的异步状态。
  • 如何将应用的初始化状态传递到客户端。
  • 哪些生命周期函数可以用于服务端的渲染。
  • 如何为应用提供同构路由支持。
  • 单例、实例以及上下文的用法。

渲染函数

render()

我们常见的render方法,用于浏览器渲染。

import ReactDOM from ‘react-dom‘;
ReactDOM.render(
  element,
  container,
  [callback]
)

renderToString()

ReactDOMServer.renderToString是两个服务端渲染函数中的一个,也是开发主要使用的一个函数,ReactDOM.render不同,该函数去掉了用于表示渲染位置的参数。取而代之,该函数只返回一个字符串,这是一个快速的同步(阻塞式)函数,非常快。

  • 用法:
const ReactDOMServer = require(‘react-dom/server‘);
ReactDOMServer.renderToString(element)
  • 例子:
const ReactDOMServer = require(‘react-dom/server‘);
const Hello = React.createClass({
  render: function() {
    return <div>hello</div>;
  }
});
const helloString = ReactDOMServer.renderToString(
  React.createElement(Hello)
);
/*
输出结果大概为:
helloString = `
<div
  data-reactid=".xxx"
  data-react-checksum="-123456"
>
  hello
</div>
`
*/

从上面这个例子,很容易发现,React为div注入了一些自定义属性,首先reactid,这是在浏览器环境下,React为了区分DOM节点,在需要更新的时候能够精确定位的标记。而后checksum这个属性仅仅存在与服务端,这个你可能没见过,或没留意,它的作用是拿服务端返回的String与已创建的DOM做校验,这就准许了React在客户端和服务端在结构上拥有相同的DOM结构,该属性只会添加在根节点元素上。拿到checksum大抵会做一些事情:

  • 检查第一个元素是否有data-react-checksum属性,如果有则通过ReactDOMServer.renderToString拿到前端的,通过adler32算法得到的值和data-react-checksum对比,如果一致则表示,无需渲染,否则重新渲染。

renderToStaticMarkup()

import ReactDOMServer from ‘react-dom/server‘;
ReactDOMServer.renderToStaticMarkup(element)
// eg:
ReactDOMServer.renderToStaticMarkup(
  React.createElement(
    Provider,
    { store },
    React.createElement(
      RouterContext,
      matchedData[1]
    )
  )
);

这个函数和上面的那个函数大体相同,除却,它不会给节点添加任何额外的属性值,它的返回值是『干净』的,在某种情况下,可以节约空间使用。

选择

每个渲染函数都有自己的用途,所以你必须明确自己的需求,再去决定使用哪个渲染函数。当且仅当你不打算在客户端渲染这个React Component时,才应该选择使用ReactDOMServer.renderToStaticMarkup函数。下面有一些示例:

  • 生成HTML电子邮件
  • 通过HTML到PDF的转化来生成PDF
  • 组件测试
  • 等一些需要『纯』DOM的情况下

大多数情况下,我们都会选择使用ReactDOMServer.renderToString。这将准许React使用data-react-checksum在客户端迅速的初始化同一个React Component,因为React可以重用服务端提供的DOM,所以它可以跳过生成DOM节点以及把他们挂载到文档中这两个昂贵的进程,对于复杂些的站点,这样做就会显著的减少加载时间,用户可以更快的与站点进行交互。确保React Component能够在服务端和客户端准确的渲染出一致的结构是很重要的。如果data-react-checksum不匹配,React会舍弃服务端提供的DOM,然后生成新的DOM节点,并且将它们更新到文档中。此时,也就不具备服务端渲染带来的各种性能上的优势。这个错误会是下面这样的,如果你开了React dev模式:

Warning: React attempted to reuse markup in a container but the checksum was invalid. This generally means that you are using server rendering and the markup generated on the server was not what the client was expecting. React injected new markup to compensate which works but you have lost many of the benefits of server rendering. Instead, figure out why the markup being generated is different on the client or server:
 (client) <noscript data-reacti
 (server) <div data-reactid=".q

而解决这个问题,则是保证在服务器环境下能够渲染出与客户端一样的DOM结构,总结一下一般会是两种情况:

  • 异步/延迟加载
  • 存在随机逻辑
  • 最大的问题是,客户端和服务端的环境差异造就的问题,如document环境下的一些元素无法在服务端渲染等

总结

上面讲了些服务器渲染需要注意到的点,而一开始提到的按需加载刷新页面出现的闪屏问题还没有落实。以下:在异步加载的时候服务器渲染和客户端渲染的结果不同,即通过checksum校验失败,重新渲染,在这个重新渲染的时候,需要重新匹配路由,以上就会出现闪屏的情况。我们注意到,在使用react-router的时候,服务器中使用到了一个match函数

match({ history, routes: getRoutes(store), location: req.originalUrl }, (error, redirectLocation, renderProps) => {})

简单的说他匹配分析了客户端的路由,使得渲染过程中能够吻合到客户端的路由控制器。而如果客户端在首次出现需要重新渲染的时候,如果是动态路由(按需加载使用到的一项技术),就需要重新匹配渲染,这时候会出现短暂的白屏闪过。解决这个问题,只需要在客户端渲染之前先匹配路由,使用match。(关于match的详细介绍,参见官方文档)

// +redux
// 客户端在渲染前加上匹配路由函数match
match({ history, routes }, (error, redirectLocation, renderProps) => {
  if (!error) {
    // 渲染
    ReactDOM.render(
      <Provider store={store}>{routes}</Provider>,
      document.getElementById(‘root‘)
    );
  } else {
    console.error(error);
    // todo: 错误信息收集
  }
});

以上,便可解决题中问题。

时间: 2024-10-06 23:18:03

React Router 按需加载+服务器渲染的闪屏问题的相关文章

vue router按需加载

1 import Vue from 'vue' 2 import Router from 'vue-router' 3 4 Vue.use(Router); 5 //按需加载,当渲染其他页面时才加载其组件,并缓存,减少首屏加载时间 6 const Index = resolve => require(['@/views/Index.vue'], resolve) 7 const Category = resolve => require(['@/views/Category.vue'], re

使用react dva按需加载

然后子路由组件会报错. Add "publicPath": "/" to .webpackrc or .roadhogrc can fix this issue export default function RouterConfig({ history,app }) { const LoginPage = (dynamic as any)({ app, component:()=>import('./routes/LoginPage/LoginPage')

利用 React/Redux/React-Router 4/webpack 开发大型 web 项目时如何按需加载

如何设计一个大型 web 项目? React + webpack 如何按需加载? React + React-Router 4 + webpack 如何按需加载? React + Redux + React-Router 4 + webpack 如何按需加载? 实录提要: bundle-loader 和 Webpack 内置的 import() 有什么区别? 按需加载能否支持通过请求后台数据,动态配置页面的的应用场景? 参与过几个 React 项目,被依赖包搞的晕晕的,不知道该怎么选择? 什么包

React 按需加载 - 代码分隔

代码分隔 我们现在大多数React项目都是以Webpack 或者 Browserify等将一堆的jsx文件组织一起,并且由一个类似index.js的入口文件串联起来的单页面web页面. 例如: // math.js export function add(a, b) { return a + b; } App: // app.js import { add } from './math.js'; console.log(add(16, 26)); // 42 打完包后: function add

react 中使用import()实现按需加载报错 解决方法 --‘import’ and ‘export’ may only appear at the top level

因为项目需要搞一下按需加载,使用import实现代码打包分片按需加载,但是在实际使用中报语法错误.报错信息如下 SyntaxError: 'import' and 'export' may only appear at the top level 啊咧?报错了. 查找发现很多人碰到过,解决方法不同,但是我这个报错适用下边这个方法. npm install --save-dev babel-plugin-syntax-dynamic-import 然后调整babel-loader配置如下: use

react中执行yarn eject配置antd-mobile的按需加载

在使用react做项目时如果用antd-mobile,如果使用按需加载,则需要修改它的配置文件 如果我们不操作yarn eject,则直接操作下面的步骤即可: 在 create-react-app 搭建脚手架时 cnpm install -g create-react-app create-react-app reactDemo cd reactDemo cnpm start 引入 antd-mobile 因为配置文件隐藏了,从而我们需要引入 react-app-rewired 并修改 pack

React引入AntD按需加载报错

背景:React使用create-react-app脚手架创建,然后yarn run eject暴露了配置之后修改less配置, 需求:实现antd组件按需加载与修改主题. 一开始是按照webpack.config.dev.js文件中的配置进行less的配置. 可以看到脚手架创建的config文件为加载loader写了一个公共方法,不是以前的webpack配置,所以仿照他的方式进行配置less文件. 直接复制css的配置,修改成less的配置,然后yarn start重启项目. 此时可以加载le

react+mobx+antd按需加载 出现Support for the experimental syntax &#39;decorators-legacy&#39; isn&#39;t currently enabled

baidu上面的说法大多是在 项目的package.json 中添加decorators-legacy 因为引入了antd的按需加载 所以只需要在config-overrides.js中添加addDecoratorsLegacy() const { override, fixBabelImports,addDecoratorsLegacy } = require('customize-cra'); module.exports = override( fixBabelImports('impor

react中使用antd按需加载(第一部)

什么是react按需加载?简单来说就是当我们引用antd的时候需要引入全局css样式,这会对性能造成一定的影响,那么使用按需加载以后就不需要引入css全局样式了,直接引入功能模块即可,既然需要设置按需加载就要对webpack文件进行修改,需要我们执行npm run eject命令来展开项目的隐藏文件,如果只是简单的修改,我们可以使用react-app-rewired定义全局变量,react-app-rewired的作用就是在不eject的情况下,覆盖create-react-app的配置.具体如