Rax Server Side Render Plugin for Egg
$ npm i egg-view-rax-ssr --save// {app_root}/config/plugin.js
exports.raxssr = {
enable: true,
package: 'egg-view-rax-ssr',
};// {app_root}/config/config.default.js
exports.raxssr = {
// doctype: '<!doctype html>',
// layout: path.join(app.baseDir, 'app/view/layout.html'),
// manifest: path.join(app.baseDir, 'config/manifest.json'),
// injectHeadRegex: /(<\/head>)/i,
// injectBodyRegex: /(<\/body>)/i,
// injectCss: true,
// injectJs: true,
// crossorigin: false,
// injectRes: [],
// mergeLocals: true,
// fallbackToClient: true, // fallback to client rendering if server render failed
// afterRender: (html, context) => { /* eslint no-unused-vars:off */
// return html;
// },
};see config/config.default.js for more detail.
when server render bundle error, will try client render**
// controller/home.js
exports.index = function* (ctx) {
yield ctx.render('index/index.js', { message: 'egg rax server side render'});
};when client render, render layout
exports.raxssr.layoutby Rax
// controller/home.js
exports.client = function* (ctx) {
yield ctx.renderClient('index/index.js',{ message: 'egg rax client render'});
};- when asset render, you can render layout
exports.raxssr.layoutby viewEngine, default useegg-view-nunjucks - you must install the specified engine dependence, such as
egg-view-nunjucksoregg-view-ejs - The context provides an
assetobject that can getjs,css,stateinformation. layout template
// controller/home.js
exports.asset = function* (ctx) {
yield ctx.renderAsset('index/index.js', { message: 'egg rax asset render'});
};// controller/home.js
exports.asset = function* (ctx) {
yield ctx.renderAsset('index/index.js', { message: 'egg rax asset render'}, { viewEngine: 'ejs' });
};Rax server side render example, please see egg-react-webpack-boilerplate
Please open an issue here.