Node.js 使用jade模板引擎的示例
在“node.js开发入门——express安装与使用”里，我们曾经使用express generator创建了一个helloexpress网站，express工具为我们生成了基本的目录结构、模板、stylesheet、routers等。虽然那只是一个简单的helloworld类的小东西，可里面包含的内容还是有些多了，为了更好的理解express所支持的jade模板引擎的用法，我们这次提供一个手动创建的小网站，可以显示来访者的ip，并对访问进行计数。
安装jade
npm install -g jade
执行上面的命令，全局安装。
visitor网站
第1步，在myprojects目录下创建一个visitor目录。
第2步，把下面的代码保存在package.json文件里：
{
"name": "visitor",
"version": "0.0.0",
"private": true,
"dependencies": {
"express": "~4.13.1",
"jade": "~1.11.0",
}
}
这个json文件描述了我们的visitor网站的一些信息，最重要的部分是依赖。我们要使用express和jade。
var express = require('express');
var app = express();
var counter = 0;
// view engine setup
app.set('views', './views');
app.set('view engine', 'jade');
app.engine('jade', require('jade').__express);
app.get('/', function(req, res) {
counter++;
app.locals.counter = counter.tostring();
res.render('index', {ip: req.ip});
});
app.listen(3000);
app.locals.title = "welcome to visitor";
app.locals.counter = "0";
app.js文件是我们网站的入口。
第4步，创建一个views目录，在里面创建一个模板文件index.jade，内容如下：
doctype html
html
head
title= title
body
h1= title
p hello, #{ip}
p you're the #{counter} visitor.
第5步，在visitor目录里执行“npm install”，安装依赖。
第6步，在visitor目录里执行“node app.js”，启动网站。
最后呢，就可以在浏览器里访问了，地址栏里输入“http://localhost:3000”即可，刷新几次，你可能会看到下面的界面：
这个简单的visitor网站，和之前的helloworld、helloexpress都不太一样了，它有了一些动态的内容。接下来我们就来看看这一切是如何发生的。
express与模板引擎
我在visitor里使用了模板引擎，类似的还有ejs以及很多，可以访问这里来了解：https://github.com/joyent/node/wiki/modules。
模板引擎使用模板文件来动态生成html文件，在生成时又可以按照一定的规则将应用程序里的数据整合进html文件。这样，我们既避免了手动编写html的繁琐（相对使用模板而言），又能生成具有动态内容的网页。
express和jade结合得比较好，我们来看看怎么配置它。
express配置jade
express服务器的行为可以通过一些设置选项来控制，这些选项可以通过express对象的set(setting, value)、enable(setting)和disable(setting)来设置。具体支持哪些设置，可以看这里。我们的visitor只用到了“view engine”和“views”。
“view engine”选项用来设置要使用的引擎，visitor的代码如下：
app.set('view engine', 'jade');
“views”选项用来设置模板文件所在目录，visitor的代码如下：
app.set('views', './views');
我在这里简单的使用了相对路径，更好的做法是使用path模块，根据全局变量__dirname来拼接。__dirname指当前正在执行的脚本所在的目录，对我们的visitor示例来讲，就是app.js所在的那个目录。代码可能是这样的：
var path = require('path');
path.join(__dirname, 'views');
express默认会根据模板文件的扩展名来使用对应的引擎。对于*.jade文件，express内部会调用下面的语句：
app.engine('jade', require('jade').__express);
所以，我们的app.js，实际上也可以去掉这行代码，结果是一样的。
本地对象
我们可以在模板文件里包含动态数据，这些动态数据来自应用程序。我们可以使用express对象的locals对象来存储本地变量。下面的代码就存储了标题和访问计数：
app.locals.title = "welcome to visitor"; app.locals.counter = "0";
jade模板文件里可以直接访问express对象的locals对象的属性。我在app.js里设置的title和counter，在index.jade模板文件引用了它们。
现在我们来看这行代码：
res.render('index', {ip: req.ip});
它调用express的response对象的render方法来渲染模板文件，并且传递了一个本地对象。render方法原型：
res.render(view [, locals] [, callback])
res.render方法渲染一个view并且把渲染生成的html字符串发送给客户端。res的api参考在这里。
response对象也有一个locals对象，它和app.locals的区别是，res的locals只在当前渲染的view内有效，而app.locals是全局的。
另外render方法的可选参数locals，也可以定义本地变量对象，传递给view。我在代码里把ip传了过去。
在jade文件里，常见的有两种方式可以调用由应用程序传入的本地变量：
- #{表达式}
- 标签=表达式
前面的index.jade模板文件里，对于页面标题，我们这么用的：
title= title
title是jade用来定义html文档title的标签。
对于body里的一级标题，我们这么用的（h1是jade用来定义html一级标题的标签）：
h1= title
这都是属于“标签=表达式”这种调用方式，这种方式通常用在一行jade代码的开始，也就是标签开始的地方。而“#{表达式}”这种方式的好处是可以插入到jade模板文件的任意地方。比如：
p hello, #{ip}
p you're the #{counter} visitor.
我们也可以将“h1= title”修改为“h1 #{title}”，效果一样。
jade引擎简介
jade使用一些标签来标记如何生成html，jade模板文件看起来很不像html文件，但它的模板文件小而整洁。使用jade，需要了解它都支持哪些标签，这个可以直接去看，那里最详细也最权威，我们这里只介绍index.jade文件用到的那些标签。
关于jade，有两篇文章不错，可以看看，和，后面这篇文章是网友根号三写的一个关于jade的系列文章的开篇，整个系列里的文章都值得一看。
html文档的开始通常是文档声明，对应到jade模板文件里，就是doctype html。还有其它的文档类型，比如xml，可以写作doctype xml。更多请参考。
jade有很多标签，用于生成html对应的标签。比如html对应，head对应，body对应，p对应，title对应，这也是我们的index.jade用到的所有标签了。通常我们在html里使用的标签写法，去掉尖括号就成了jade里可用的标签，比如对应jade里的div。
html标签往往可以设置name、id、class等属性，在jade里，是通过tag(attr=value)这种形式表示的。比如div(class=”view-container”)，又比如input(type=”checkbox”)。
关于jade标签，这篇文章说得很好，请参考。
测试jade模板文件
一开始用jade模板，记不全它的标签，也经常不知道自己的写的模板文件生成的html文档是否正确。还好安装jade后，有一个命令行工具jade，可以用来验证模板文件。
jade的用法如下：jade [options] [dir|file …]
jade命令有很多选项，可以执行“jade -h”查看。要验证模板文件，最简单的办法就是使用jade工具生成为html文档。命令如下：
jade xxx.jade
执行上面的命令，就会在当前目录下生成一个与模板文件同名的html文档。不过格式很难读，完全是一坨屎挤在一起。加上 -p(–pretty) 就好了。这样：
jade -p xxx.jade
比如我们有这么一个使用了angularjs的模板文件scope_template.jade，内容如下：
doctype html
html(ng-app="myapp")
head
title= title
link(rel='stylesheet', href='/stylesheets/style.css')
body
div(ng-controller="simpletemplate")
| valuea:
input(type="number" ng-model="valuea")
br
| valueb:
input(type="number" ng-model="valueb")
br
br
| expression value: {{valuea + valueb}}
br
br
input(type="button" ng-click="addvalues(valuea, valueb)" value="click to add values {{valuea}} & {{valueb}}")
br
| clicked value: {{valuec}}
br
script(src="/javascripts/angular-1.4.3.min.js")
script(src="/javascripts/scope_template.js")
运行“jade -p scope_template.jade”命令会生成scope_template.html文件，内容如下：
<!doctype html>
<html ng-app="myapp">
<head>
<title></title>
<link rel="stylesheet" href="/stylesheets/style.css" rel="external nofollow" >
</head>
<body>
<div ng-controller="simpletemplate">valuea:
<input type="number" ng-model="valuea"><br>valueb:
<input type="number" ng-model="valueb"><br><br>expression value: {{valuea + valueb}}<br><br>
<input type="button" ng-click="addvalues(valuea, valueb)" value="click to add values {{valuea}} & {{valueb}}"><br>clicked value: {{valuec}}<br>
</div>
<script src="/javascripts/angular-1.4.3.min.js"></script>
<script src="/javascripts/scope_template.js"></script>
</body>
</html>
需要提一下，我们既可以用jade编写完整的html文档，也可以编写符合html语法的局部模板。比如下面的jade文件：
div(class="admin-user") p 添加用户 table tr td label 用户名： td input(type="text" name="add_username") tr td label 密码： td input(type="text" name="add_password") tr td(colspan='2' align="right") input(type="submit" value="增加")
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。