过滤器能对输入参数执行转换。

过滤器是在渲染时间执行的，所以不管怎么样它们都不会直接修改编译后的模板结构。

Swig所有的内置过滤器都是以同样的方式编写的。查看更多的栗子，请在Swig源码中参考 `filters.js` 文件。

如需禁止定制过滤器的自动转义，给过滤器方法增加 `safe = true;` 属性即可，这样无论Swig的全局设置是什么，输出都不会被转义。

参数

// This filter will return 'bazbop' if the idx on the input is not 'foobar'
swig.setFilter('foobar', function (input, idx) {
  return input[idx] === 'foobar' ? input[idx] : 'bazbop';
});
// myvar = ['foo', 'bar', 'baz', 'bop'];
// => {{ myvar|foobar(3) }}
// Since myvar[3] !== 'foobar', we render:
// => bazbop

// This filter will disable auto-escaping on its output:
function bazbop (input) { return input; }
bazbop.safe = true;
swig.setFilter('bazbop', bazbop);
// => {{ "<p>"|bazbop }}
// => <p>

parse(str, line, parser, types, stack, options, swig)

为你的标签定义定制的解析方法。

方法

exports.parse = function (str, line, parser, types, options, swig) {
  parser.on('start', function () {
    // ...
  });
  parser.on(types.STRING, function (token) {
    // ...
  });
};

compile(compiler, args, content, parents, options, blockName)

为VarToken和TagToken对象编译回调。

参数

exports.compile = function (compiler, args, content, parents, options, blockName) {
  if (args[0] === 'foo') {
    return compiler(content, parents, options, blockName) + '\n';
  }
  return '_output += "fallback";\n';
};

ends

当一个标签在模板中被声明后，控制该标签时是否必须有一个{% end[tagName] %} 。

exports.ends = true;
// => A template that fails to close this tag will throw an Error.

exports.ends = false;
// => A template attempts close this tag will throw an Error.

blockLevel

当扩展一个父级模板时，允许标签在 {% block <name> %}{% endblock %} 标签外部被重写。

exports.blockLevel = true;

{% extends "foo" %}
{% mytag foo bar baz %}
// Normally this will be ignored, but since we allowed it to be block-level,
// it will be included in the fully-parsed template.

{% block content %}
  ...
{% endblock %}

TYPES

Source: lib/lexer.js#L16

枚举token types.