typescript-koa-ssr-react-boilerplate
项目地址:https://github.com/m-Ryan/typ…
特色
- 前后端分离
- typeScript
- 服务端渲染
- react-router按需加载
- redux
- 使用最新的react v.16.4
服务端渲染实现
router.tsx 路由
...
function RouterConfig() {
return (
<Switch>
<Route path="/" exact={true} component={Home} />
<Route path="/about" component={About} />
<Route path="/hello" component={Hello} />
</Switch>
);
}
ssr.tsx 匹配路径
...
export default (url: string | Object, context: any,store: any)=>{
return <Provider store={store}>
<StaticRouter location={url} context={context}>
<Routes/>
</StaticRouter>
</Provider>
}
renderFullPage.ts 渲染页面
...
const renderFullPage = (ctx : IRouterContext, newState:Object ) => {
let context = {}
const myHtml = fs.readFileSync("app/web/assets/dist/templete.html", 'utf-8');
// 得到初始 state 创建新的 Redux store 实例
const store = createStore(reducers, newState);
// 从 Redux store 得到初始 state,注入到window
const finalState = store.getState()
let initState = `<script> window.__INITIAL_STATE__ = ${JSON.stringify(finalState)}</script>`;
//根据路由获取html并注入到<div id="root"></div>,将 initState 插到该节点后面
const html = ReactDOMServer.renderToString(ssr(ctx.req.url, context, store));
let renderPage = myHtml.replace(/(\<div\s+id\="root"\>)(.|\n|\r)*(\<\/div\>)/i, "$1" + html + "$3" + initState);
ctx.type = 'html';
ctx.body = renderPage;
}
export default renderFullPage;
index.tsx 前端的路由处理
...
const preloadedState = window.__INITIAL_STATE__ || {} //
// 使用初始 state 创建 Redux store
const store = createStore(reducers, preloadedState)
render(
<Provider store={store}>
<BrowserRouter>
<Routes/>
</BrowserRouter>
</Provider>,
document.getElementById('root') as HTMLElement
)
1..redux方面,先创建新的 Redux store 实例,将我们需要初始的state合并到 store
2.通过 store.getState() 获取最终的finalState
3.通过 StaticRouter 可以获取路径匹配的页面组件,并通过 ReactDOMServer.renderToString 转化为HTML元素
ssr.tsx 主要做了两件事:
1.将初始的 store 注入redux
2.返回带有 store 数据的路径匹配的页面组件,也就是说这个页面已经是有初始数据了4.将读取的html模板注入数据,在这里我们需要通过简单的正则替换一下
在 <div id=”root”></div> 中插入我们的html元素
在 <div id=”root”></div> 后面插入<script> window.__INITIAL_STATE__ = ${JSON.stringify(finalState)}</script>
5.将这个页面发送出去
6.js加载的时候会读取
window.__INITIAL_STATE__
的数据,合并到 store
注意:这里 我们是用 fs模块 读取 html模板,而不是直接使用 类似以下函数
export default (html, finalState)=>(
`
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width,initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no">
<meta http-equiv="X-UA-Compatible" content="IE=edge, chrome=1" />
<meta name="renderer" content="webkit">
<title>typeScript-koa-ssr-antd</title>
<link href="/dist/index.076a9ad74b9f609c4d81.css" rel="stylesheet">
</head>
<body>
<div id="root">${html}</div>
window.__INITIAL_STATE__ = ${JSON.stringify(finalState)}</script>
</body>
</html>
`
)
原因主要是因为打包得到的 js、css 需要有hash值来管理版本缓存,所以是不能直接写死的
怎么使用
git clone git@github.com:m-Ryan/typescript-koa-ssr-react-boilerplate.git
cd typescript-koa-ssr-react-boilerplate
前端
- cd app/web 首次使用,先 npm install
- 开发环境 npm start
- 生产环境 npm run build
后台(前后端是分离的,使用前,前端要先打包)
- 首次使用,先 npm install
- 开发环境 npm start
- 生产环境 npm run build