安装模板引擎
由于 doT.js 模板引擎的整体性能较优,OnceIO 采用 doT.js 作为默认模板引擎。在使用任何一种除了 doT.js 之外的模板引擎之前都需要先用 cmd 在项目文件夹安装这种模板引擎。以使用 Git Bash 安装 EJS 为例,使用的命令是:
$ npm install ejs
Git Bash 界面如下:
使用模板引擎
在项目文件夹中创建 websvr.js 文件,以使用 doT.js 模板引擎为例,websvr.js 的代码如下:
var onceio = require('../onceio/onceio')
var app = onceio({
home : "./"
, port : 8054
, listDir: true
, debug : false
})
app.get('/dot', function(req, res) {
res.render('dot.tmpl', {
username: 'Kris'
})
})
创建好服务器文件后,再在项目文件夹中创建一个模板文件 dot.tmpl,代码如下:
<!DOCTYPE html>
<body>
<h1> Hello, {{=it.username}} </h1>
</body>
</html>
运行服务器,在浏览器中打开 localhost:8054/dot,得到以下结果:
可以注意到,这个网页和的内容是由前端文件和后端文件共同决定的,这就是使用了模板引擎的结果。
更换模板引擎
OnceIO 支持所有 Node.js 模板引擎,您可以根据自己的需要或喜好更换模板引擎。
例如,当您想使用 EJS 模板引擎时,可在项目文件夹中安装 EJS 后将 websvr.js 中的 app.get 函数替换成:
app.engine('ejs', require('ejs').render)
app.get('example_ejs', function(req, res) {
res.render('example_ejs.ejs', {
username: 'Kris'
})
})
OnceIO 的模板引擎接口与 Express 有一些不同:在使用 EJS 或 pug 时,Express 中 require 函数的第一个参数为模板文件路径,而 OnceIO 中则为模析文件内容,几乎所有的模板引擎文件都提供直接渲染内容的接口,比如: require('pug').render 或 require('ejs').render
// Comparison between Express and OnceIO when using EJS
require('ejs').__express(path, option)
require('ejs').render(content, option)
//Comparison between Express and OnceIO when using pug
require('pug').__express(path, option)
require('pug').render(content, option)
模板文件 example_ejs.ejs 的代码为:
<!DOCTYPE html>
<body>
<h1> Hello, <%= username %> </h1>
</body>
</html>
当您想使用 pug 模板引擎时,可在项目文件夹中安装 pug 后将 websvr.js 中的 app.get() 部分替换成:
app.engine('pug', require('pug').render);
app.get('/example_pug', function(req, res) {
res.render('example_pug.pug', {
username: 'Kris'
, youAreUsingPug: true
})
})
模板文件 example_pug.pug 的代码为:
doctype html
html
body
h1 Hello, #{username}
OnceIO地址: https://github.com/OnceDoc/onceio