react ssr 初体验
用到的技术栈
react 16 + webpack3 + koa2
看看它是如何实现服务端渲染的,here we go!
为什么要用服务端渲染
优点
无非就是两点
- SEO 友好
- 加快首屏渲染,减少白屏时间
那么问题来了什么是SEO
直接放文章不做赘述,前端后端分离,怎么解决SEO优化的问题呢? - 知乎,
一句话介绍就是,现在我们做的大多是SPA网站,所有页面啊数据啊都是ajax来的,搜索引擎的spider来收录网页的时候,发现全空?那么你觉得你的网站收录的权重跟效果是好还是不好?
而我们对SEO优化,也是下面内容所描述的核心就是:
下面是重点!
让服务器把有内容的HTML返回给我们,事件的话浏览器再渲染一次来进行挂载
搭建 koa 环境
新建一个 ssr 项目,并在项目中初始化 npm
mkdir ssr && cd ssr
npm init
下面的代码我们用到了 import jsx 等语法,node环境是不支持的,所以需要配置babel
在当前项目中新建文件 server.js跟index.js,然后
babel的入口, index.js代码如下
require('babel-core/register')()
require('babel-polyfill')
require('./server')
我们项目的入口, server.js代码如下
import Koa from 'koa'
const app = new Koa()
// response
app.use((ctx) => {
ctx.body = 'Hello Koa'
})
app.listen(3000)
console.log("系统启动,端口:3000")
根目录下新建一个.babelrc文件
内容是:
{
"presets": ["react", "env"]
}
安装上面所需要的依赖
npm install babel-core babel-polyfill babel-preset-env babel-preset-react nodemon --save-dev
npm i koa --save
配置启动脚本
package.json
"scripts": {
"dev": "nodemon index.js",
}
到这里你运行 npm run dev 打开localhost:3000
你就会看到 hello Koa了
是不是很简单就起了一个服务
安装React
cnpm install react react-dom --save
在根目录下新建一个app文件夹,并在文件夹中个新建一个main.js
main.js代码如下
import React from 'react'
export default class Home extends React.Component {
render () {
return <div>hello world</div>
}
}
修改之前server.js
import Koa from 'koa'
import React from 'react'
import { renderToString } from 'react-dom/server'
import App from './app/main'
const app = new Koa()
// response
app.use(ctx => {
let str = renderToString(<App />)
ctx.body = str
})
app.listen(3000)
console.log('系统启动,端口:8080')
这个时候再 npm run dev
你就会看到屏幕上出现hello world
这里我们用到了一个方法:
renderToString – 其实就是将组件渲染成字符串
目前为止,我们都还没有给组件加上事件等交互行为,下面那让我们来试一下
修改main.js的代码
import React from 'react'
export default class Home extends React.Component {
render () {
return <div onClick={() => window.alert(123)}>hello world</div>
}
}
再刷新一下我们的页面,,咦,是不是没有什么卵用
那是因为后端只能讲组件渲染成一串html的字符串,事件绑定等事情都是需要在浏览器端执行的
那事件我们改怎么绑定上去呢?
那你肯定就会猜到,既然服务器渲染出来的是一串html,挂载事件的方式是不是在浏览器重新渲染一次就好了呢
说干就干
配制webpack
在根目录下面新建一个 webpack.config.js
下面是webpack.config.js的内容:
var path = require('path')
var webpack = require('webpack')
module.exports = {
entry: {
main: './app/index.js'
},
output: {
filename: '[name].js',
path: path.join(__dirname, 'public'),
publicPath: '/'
},
resolve: {
extensions: ['.js', '.jsx']
},
module: {
loaders: [
{test: /\.jsx?$/,
loaders: ['babel-loader'],
}
]
}
}
上面的配置将entry设置成了app/index.js文件
那我们就创建一个
下面是app/index.js的代码:
import Demo from './main'
import ReactDOM from 'react-dom'
import React from 'react'
ReactDOM.render(<Demo />, document.getElementById('root'))
因为浏览器渲染需要将根组件挂载到某个dom节点上,所以给我们的react代码设置一个入口
这个时候就有一个问题,就是,document对象node环境下并不存在,那怎么解决的呢?
不存在?不存在那我就不用就好了,SSR核心就是让请求的url里面返回具体HTML内容,事件什么的并不care,那么我就把根组件直接renderToString
返回出来就好了呗
下面修改我们的服务代码,让代码支持服务器渲染
新增一点依赖
cnpm i --save koa-static koa-views ejs
- koa-static: 处理静态文件的中间件
- koa-views: 配置模板的中间件
- ejs:一个模板引擎
修改server.js
的代码
import Koa from 'koa'
import React from 'react'
import { renderToString } from 'react-dom/server'
import views from 'koa-views'
import path from 'path'
import Demo from './app/main'
const app = new Koa()
// 将/public文件夹设置为静态路径
app.use(require('koa-static')(__dirname + '/public'))
// 将ejs设置为我们的模板引擎
app.use(views(path.resolve(__dirname, './views'), { map: { html: 'ejs' } }))
// response
app.use(async ctx => {
let str = renderToString(<Demo />)
await ctx.render('index', {
root: str
})
})
app.listen(3000)
console.log('系统启动,端口:8080')
下面新建我们的渲染模板
新建一个views文件夹
里面新建一个index.html:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>Document</title>
<base href="/client">
</head>
<body>
<div id="root"><%- root %></div>
<script src="/main.js"></script>
</body>
</html>
这个 html
里面可以放一些变量,比如这个<%- root %>
,就是等下要放renderToString结果的地方
/main.js
则是react构建出来的代码
下面直接来测试一下我们的代码
1. 在 package.json里面
新增:
"scripts": {
"dev": "nodemon index.js",
"build": "webpack"
},
2. 运行 npm run build, 构建出我们的react代码
3. npm run dev
点击一下代码,是不是会 alert(123)
到这里核心的思想就都已经讲完了,总结来说就下面三点:
- 起一个node服务
- 把
react
根组件renderToString
渲染成字符串一起返回前端 - 前端再重新
render
一次