欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  web前端

webpack+react+nodejs服务端渲染_html/css_WEB-ITnose

程序员文章站 2022-03-31 17:29:26
...

前端时间用react写网站,但是一直都是采用前端渲染的方式。最近两天有时间,研究一下怎么实现react的后端渲染。

一、环境

  • Webpack
  • React
  • NodeJS

二、思路

前端构建工具采用了Webpack,React组件使用ES6语法编写。由于Webpack支持像引入普通JS模块一样引入图片、样式等资源文件,所以React组建内的图片和样式都是通过import方式引入的。因此,要实现服务端渲染,要做三件事情。

  1. 编写后端渲染所需的入口文件,该入口文件的主要作用是输出首页HMTL;
  2. 使用Webpack编译入口文件,使得Node解析器能够加载并执行(因为React组件是使用ES6语法编写的,而且图片和样式文件的加载使用的是只有Webpack能够识别的模块加载方式,所以Node解析器是无法直接加载执行后端入口文件的)
  3. 把样式代码从React组件中提取出来,放到上一步生成的HTML代码中,这样浏览器才能正常显示从服务端发送过去的页面。

三、遇到的问题

本次代码实现上借鉴了Webpack官方提供的例子:react-webpack-server-side-example,但是遇到几个坑。

坑一: Webpack版本不一样,导致直接使用官方例子提供的style-collector.loader.js提取CSS代码时失败。

官方例子使用的Webpack版本是"webpack": "~1.3.1-beta7",而我使用的Webpack版本是"webpack": "^1.12.2"。可能是由于版本升级导致API有所变化,所以当在style-collector.loader.js文件里面调用下图这一段代码去提取CSS时红色框框内的那一句话直接返回的并不是CSS代码,而是一个数组。

style-collector.loader.js

提取CSS代码时的结果图

所以,我把在红色框框的那一段代码后面加了数组索引[0][1]

修改后

这样返回的就是要提取的CSS了。

坑二: 官方版本的提取CSS的代码直接搬过来不能用,提取不到任何东西,即使解决了坑一

让我们来看看官方的例子是怎么提取CSS的。首先:官方的style-collector.loader.js是这样的。

style-collector.loader.js

这段代码定义了一个Webpack loader,即加载器。它的大概意思就是,在加载css文件的地方,插入一段JS代码,这段JS代码的作用是调用style-collector.js的add方法,而css代码会转成字符串作为参数传给add方法。

然后,我们来看看style-collector.js文件,它是这样的。

style-collector.js

这个模块定义了两个方法,一个collect方法和一个add方法。其中,默认定义的add方法是一个空方法。有点奇怪,我们继续往下看。在官方例子的服务端入口文件page.js里面,有这么一段:

page.js

红色框框内的代码是提取CSS用的,这里调用了style-collector.js的collect方法,然后传了一个回调函数给collect方法,回调函数的作用是把Application组件渲染成字符串。那么这里是怎么提取CSS呢?回头看看style-collector.js的内容,在collect方法里面,执行回调函数之前,定义了一个stuff数组用于存放CSS,并且改变了模块默认的add方法;执行回调函数之后,就返回了CSS了。所以,所有把戏都藏在回调函数里头。那么,执行回调函数的时候发生了什么呢?我们知道,回调函数只做了一件事,那就是把Application组件渲染成字符串。让我们来看看Application组建的内容。

Paste_Image.png

Soga!原来在Application组件渲染的时候,加载了Application.css文件,而先前说过,style-collector.loader.js这个加载器会在加载CSS文件的地方插入一段JS代码,这段JS代码的作用是调用style-collector.js的add方法,而css代码会转成字符串作为参数传给add方法。所以,在执行回调函数的过程中,调用了一次style-collector.js的add方法,把CSS添加到了stuff数组中,所以执行完回调函数之后,自然就提取到了CSS。

好了,了解完官方提取CSS的原理,来看看我的代码是怎么写的。首先,我的React组件是这样写的。

我的React组件

与官方的区别在于,我是在组件的头部,而不是在render方法中引入CSS文件的。问题就出在这里。如果我把CSS文件的引入写在组件的头部,用Webpack编译的时候,style-collector.loader.js会在组件头部插入一段JS代码,这段JS代码的作用上面已经提过了,就是调用style-collector.js的add方法。当我从page.js里面引入组件的时候(也是在page.js的头部引入),就已经执行了这一段代码,而此时style-collector.js的collect方法还没有被执行,默认的add方法还没有被改变,所以最终提取不到CSS。

所以,我把style-collector.js的内容作了修改,如下图:

修改后的style-collector.js

这样,无论从哪里加载CSS文件,都可以把CSS添加到stuff数组中,最后调用collect方法即可获取所有的CSS。如下图:

修改后的page.js

四、总结

  • 代码不能照搬照抄,要理解其原理,然后根据自己的实际情况加以运用。其实官方文档开头就写了You shouldn't use the code, only the idea. 啪啪,打脸!

    Webpack Github 文档

  • 很久没有体验这种发现问题与解决问题的乐趣了,我记得从小我就很喜欢这种乐趣。不忘初心,方得始终!