nodejs前端模板引擎swig入门

96
程序鱼
0.2 2017.01.24 11:00* 字数 950

相对于jade,我还是更喜欢swig前端模板引擎,jade虽然语法简练高效了不少,但是在我这最大的问题是

他没有一个html该有的样子。。。

所以我还是决定使用swig,页面结构,样子都是熟悉的样子,使用起来顺手了许多。
很多朋友也在纠结二者的优缺点,这个根据需求因人而异吧

这是两者的比较
http://vschart.com/compare/swig-template-engine/vs/jade-template-engin


下面我们一起学习下swig这个前端模板引擎

swig的简单介绍

swig是JS模板引擎,它有如下特点:

  • 支持大多数主流浏览器。
  • 表达式兼容性好。
  • 面向对象的模板继承。
  • 将过滤器和转换应用到模板中的输出。
  • 可根据路劲渲染页面。
  • 支持页面复用。
  • 支持动态页面。
  • 可扩展、可定制。

一. swig的安装

npm install swig --save

二.和express框架集成

app.js

var express = require('express');
var swig = require('swig');
var path = require('path')

var app = express();
var port = process.env.PORT || 4000

//设置swig页面不缓存
swig.setDefaults({
  cache: false
})
app.set('view cache', false);

app.set('views','./views/pages/');
app.set('view engine','html');
app.engine('html', swig.renderFile);


app.listen(port);

console.log('server is started at http://localhost:'+port);

//index page
app.get('/',function(req, res){
    res.render('index',{
        title:'首页 ',
        content: 'hello swig'
    })
})

index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{{ title }}</title>
</head>
<body>
    {{ content }}
</body>
</html>

然后测试运行

node app.js

在浏览器输入:http://localhost:4000, 执行效果如下

浏览器运行.png

三.基本用法

1.变量

{{ name }}

这里需要注意的是前后两端都要有空格,这样{{name}}写就会报错

2.属性

{{ student.name }}

3.模板继承

Swig 使用 extends 和 block 来实现模板继承 layout.html

首先我们定义一个模板

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{% block title %}{% endblock  %}</title>
    {% block head %}{% endblock  %}
</head>
<body>
    {% block content %}{% endblock  %}
</body>
</html>

这个模板里面我们定义了三个block块,子模板可以对这三个block继承

然后我们写一个index.html继承这个模板

{% extends './layout.html' %}
{% block title %} index {% endblock %}
{% block content %}
    <div>
            <h1>hello swig</h1>
     <div>
{% endblock %}

注意我这里并没有复写{% block head %}{% endblock %}这个块

也就是说我们可以在layout.html模板页面里面定义很多block,而子页面可以有选择性的实现。

4.include模板

包含一个模板到当前位置,这个模板将使用当前上下文

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{% block title %}{% endblock  %}</title>
    {% include "./includes/head.html" %}
    {% block head %}{% endblock  %}
</head>
<body>
    {% include "./includes/header.html" %}
    {% block content %}{% endblock  %}
</body>
</html>

5.if判断

{ % if name === '郭靖' % }
  hello 靖哥哥
{ % endif % }

6.if-else判断

{ % if name === '郭靖' % }
  hello 靖哥哥
{ % elseif name === '黄蓉' % }
  hello 蓉妹妹
{ % else % }
  hello 欧阳峰
{ % endif % }

7.for循环

先上栗子:

// arr = [1, 2, 3]
{ % for key, val in arr % }
  <p>{ { key } } -- { { val } }</p>
{ % endfor % }

for循环内置变量:

  • loop.index:当前循环的索引(1开始)
  • loop.index0:当前循环的索引(0开始)
  • loop.revindex:当前循环从结尾开始的索引(1开始)
  • loop.revindex0:当前循环从结尾开始的索引(0开始)
  • loop.key:如果迭代是对象,是当前循环的键,否则同 loop.index
  • loop.first:如果是第一个值返回 true
  • loop.last:如果是最后一个值返回 true
  • loop.cycle:一个帮助函数,以指定的参数作为周期

使用方法:

// arr = [1, 2, 3]
{ % for key, val in arr % }
  <p>{{ loop.index }} -- {{ key }} -- {{ val }}</p>
{ % endfor % }

8.强大的内置过滤器

  • add(value):使变量与value相加,可以转换为数值字符串会自动转换为数值。
  • addslashes:用 \ 转义字符串
  • capitalize:大写首字母
  • date(format[, tzOffset]):转换日期为指定格式
  • format:格式
  • tzOffset:时区
  • default(value):默认值(如果变量为undefined,null,false)
  • escape([type]):转义字符
  • 默认: &, <, >, ", '
  • js: &, <, >, ", ', =, -, ;
  • first:返回数组第一个值
  • join(glue):同[].join
  • json_encode([indent]):类似JSON.stringify, indent为缩进空格数
  • last:返回数组最后一个值
  • length:返回变量的length,如果是object,返回key的数量
  • lower:同''.toLowerCase()
  • raw:指定输入不会被转义
  • replace(search, replace[, flags]):同''.replace
  • reverse:翻转数组
  • striptags:去除html/xml标签
  • title:大写首字母
  • uniq:数组去重
  • upper:同''.toUpperCase
  • url_encode:同encodeURIComponent
  • url_decode:同decodeURIComponemt

使用方法:
例如我们要格式化一个时间,使用方法和linux上的管道命令非常像

{{ birthday|date('Y-m-d') }}

大写首字母

{{ name|title }}

9.set命令

用来设置一个变量,在当前上下文中复用

{% set foo = [0, 1, 2, 3, 4, 5] %}
 {% for num in foo %}
    <li>{{ num }}</li>
{% endfor %}

参考文献
http://www.iqianduan.net/blog/how_to_use_swig
http://jinfang.oschina.io/posts/124966c9/

日记本
Web note ad 1