注册标签和过滤器

注册标签

// 使用方式: {% upper name %}
engine.registerTag('upper', {
    parse: function(tagToken, remainTokens) {
        this.str = tagToken.args; // name
    },
    render: async function(scope, hash) {
        var str = await this.liquid.evalValue(this.str, scope); // 'alice'
        return str.toUpperCase()  // 'Alice'
    }
});

• parse: 从 remainTokens 中读取后续的标签/输出/HTML，直到找到你期望的结束标签。
• render: 把 scope 数据和此前解析得到的 Token 结合，输出 HTML 字符串。

查看已有的标签实现：https://github.com/harttle/liquidjs/tree/master/src/builtin/tags

注册过滤器

// 使用方式: {{ name | upper }}
engine.registerFilter('upper', v => v.toUpperCase())

过滤器的参数将会传递给上面注册的过滤器函数，从第二个参数开始（第一个参数是过滤器左侧的输入），例如：

// Usage: {{ 1 | add: 2, 3 }}
engine.registerFilter('add', (initial, arg1, arg2) => initial + arg1 + arg2)

查看已有的过滤器实现：https://github.com/harttle/liquidjs/tree/master/src/builtin/filters

反注册标签/过滤器

有时可能需要禁用一些标签/过滤器（比如 #324），注册一个假的标签/过滤器并在里面抛出相应的错误即可。

// 禁用标签
const disabledTag = {
    parse: function(token) {
        throw new Error(`tag "${token.name}" disabled`);
    }
}
engine.registerTag('include', disabledTag);

// 禁用过滤器
function disabledFilter(name) {
    return function () {
        throw new Error(`filter "${name}" disabled`);
    }
}
engine.registerFilter('plus', disabledFilter('plus'));