這篇文章主要介紹了從零開始最小實現react伺服器渲染詳解,現在分享給大家,也給大家做個參考。
前言
最近在寫 koa 的時候想到,如果我部分程式碼提供api,部分程式碼支援ssr,那我該如何寫呢? (不想拆成2個服務的情況下)
而且最近寫的項目裡面也用過一些服務端渲染,如nuxt,自己也搭過next的項目,確實開發體驗都非常友好,但是友好歸友好,具體又是如何實現的呢,各位有沒有考慮過?
本著求真務實的折騰態度,選了react作為研究對象(主要是vue寫的有點多,噁心了),那下面就簡單就以最小成本寫一個react的服務端渲染demo
用到的技術堆疊
react 16 webpack3 koa2
看看它是如何實現服務端渲染的,here we go!
為什麼要用服務端渲染
優點
無非就是兩點
#SEO 友善
加快首屏渲染,減少白屏時間
那麼問題來了什麼是SEO
一句話介紹就是,現在我們做的大多是SPA網站,所有頁面啊資料啊都是ajax來的,搜尋引擎的spider來收錄網頁的時候,發現全空?那你覺得你的網站收錄的權重跟效果好還是不好?
而我們對SEO優化,也是下面內容所描述的核心就是:
下面是重點!
讓伺服器把有內容的HTML傳回給我們,事件的話瀏覽器再渲染一次來進行掛載
建置koa 環境
新建一個ssr 項目,並在專案中初始化npm
mkdir ssr && cd ssr npm init
下面的程式碼我們用到了import jsx 等語法,node環境是不支援的,所以需要設定babel
#在目前專案中新建檔案app.js跟index.js,然後
babel的入口, index.js程式碼如下
require('babel-core/register')() require('babel-polyfill') require('./app')
我們專案的入口,app.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.jsmain.js程式碼如下
import React from 'react' export default class Home extends React.Component { render () { return <p>hello world</p> } }修改之前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再開啟chrome 開發者工具查看我們的請求: 我們的最簡單的react元件變成str傳了進來這裡我們用到了一個方法:
renderToString – 其實就是將元件渲染成字串目前為止,我們都還沒有給元件加上事件等互動行為,下面那讓我們來試試修改main .js的程式碼
import React from 'react' export default class Home extends React.Component { render () { return <p onClick={() => window.alert(123)}>hello world</p> } }再刷新一下我們的頁面,,咦,是不是沒有什麼卵用那是因為後端只能講元件渲染成一串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
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" rel="external nofollow" > </head> <body> <p id="root"><%- root %></p> <script src="/main.js"></script> </body> </html>這個html 裡面可以放一些變量,像是這個c7f7f00800564bf33bc4d7d2fb90b606,就是等下要放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)
tada 撒花,恭喜你,一个最简单服务器渲染就已经完成
到这里核心的思想就都已经讲完了,总结来说就下面三点:
起一个node服务
把react 根组件 renderToString渲染成字符串一起返回前端
前端再重新render一次
原理就是这么简单
但是具体开发的时候还会有各种各样的需求,比如:
不可能我每次改完代码都重新构建看效果吧 => 需要 实时构建
create-react-app 都是热更新,你还要刷新是不是太蠢了 => 需要支持热更新
其他一些配套的周边,如: react-router, redux 或者mobx怎么支持呢 => 需要完善的生态
.etc
这些问题都是用完 官方脚手架之后就回不去了的,所以更多的配置可以参考下面的repo(是一个工具链完善的最小实现),欢迎提PR
GitHub - ws456999/koa-react-ssr-starter: to understand && to explain how react ssr works
目前你可以在里面找到 react + react-router + mobx + postcss + 热更新的配置,除了react-router的配置有些差别,其他都跟client端差别不大
上面是我整理给大家的,希望今后会对大家有帮助。
相关文章:
以上是詳細講解有關實作react伺服器渲染問題的詳細內容。更多資訊請關注PHP中文網其他相關文章!