swig

swig是JS模板引擎，它有如下特点：

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

1、API

swig.init({
    allowErrors: false,
    autoescape: true,
    cache: true,
    encoding: 'utf8',
    filters: {},
    root: '/',
    tags: {},
    extensions: {},
    tzOffset: 0
});

options:

• allowErrors: 默认值为 false。将所有模板解析和编译错误直接输出到模板。如果为 true，则将引发错误，抛出到 Node.js 进程中，可能会使您的应用程序崩溃。
• autoescape: 默认true，强烈建议保持。字符转换表请参阅转义过滤器。
  • true: HTML安全转义
  • false: 不转义，除非使用转义过滤器或者转义标签
  • 'js': js安全转义
• cache: 更改为 false 将重新编译每个请求的模板的文件。正式环境建议保持true。
• encoding: 模板文件编码
• root: 需要搜索模板的目录。如果模板传递给 swig.compileFile 绝对路径(以/开头)，Swig不会在模板root中搜索。如果传递一个数组，使用第一个匹配成功的数组项。
• tzOffset: 设置默认时区偏移量。此设置会使转换日期过滤器会自动的修正相应时区偏移量。
• filters:自定义过滤器或者重写默认过滤器，参见自定义过滤器指南。
• tags: 自定义标签或者重写默认标签，参见自定义标签指南。
• extensions: 添加第三方库，可以在编译模板时使用，参见参见自定义标签指南。

2、nodejs

var tpl = swig.compileFile("path/to/template/file.html");
var renderedHtml = tpl.render({ vars: 'to be inserted in template' });

或者

var tpl = swig.compile("Template string here");
var renderedHtml = tpl({ vars: 'to be inserted in template' });

3、结合Express

npm install express
npm install consolidate

然后

app.engine('.html', cons.swig);
app.set('view engine', 'html');

4、浏览器

Swig浏览器版本的api基本与nodejs版相同，不同点如下：

• 不能使用swig.compileFile，浏览器没有文件系统
• 你必须提前使用swig.compile编译好模板
• 按顺序使用extends, import, and include，同时在swig.compile里使用参数templateKey来查找模板

var template = swig.compile('<p>{% block content %}{% endblock %}</p>', { filename: 'main' });
var mypage = swig.compile('{% extends "main" %}{% block content %}Oh hey there!{% endblock %}', { filename: 'mypage' });

仅供个人学习参考/导航指引使用，具体请以第三方网站说明为准，本站不提供任何专业建议。如果地址失效或描述有误，请联系站长反馈～感谢您的理解与支持！

链接: https://web.fly63.com/nav/1534