官方文档地址:https://handlebarsjs.com/zh/api-reference/data-variables.html
1、自定义函数(助手):Handlebars.registerHelper
例:
Handlebars.registerHelper(‘demo’,function(aString){
return aString.toUpperCase();
})
模板调用:
{{ demo firstName}}
函数(定义的助手)名+空格+参数
定义:
{
firstName:"Wang"
}
显示结果:
WANG
2、特殊符号不想被转意:用{{{
例:
定义:
{
specialChars:"& < > \" ' ` ="
}
模板定义:
{{specialChars}}
{{{specialChars}}}
显示结果:
& < > " ' ` =
& < > \ ' ` =
3、助手:../ 确切值为父级上下文,根据调用该块的不同而有所不同
例:
定义:
{
permalink:"111",
comments:[{ },{ }]
}
模板调用:
{{permalink}}
{{#each comments}}
{{../permalink}}
{{#if title}}
{{../permalink}}
{{/if}}
{{/each}}
4、助手
Handlebars.Safestring 防止html转意
Handlebars.escapeExpression 不改变传的值的意义,例如针对字符串的表达不转意
例:
定义:
{ url: "https://yehudakatz.com/" }
Handlebars.registerHelper("link", function(text, url) {
var url = Handlebars.escapeExpression(url), //https://yehudakatz.com/
text = Handlebars.escapeExpression(text) //"See Website"
return new Handlebars.SafeString("<a href='" + url + "'>" + text +"</a>");
});
模板定义:
{{link "See Website" url}}
输出:
<a href='https://yehudakatz.com/'>See Website</a>
自定义函数中传参高级使用:
定义:
{
person: {
firstname: "Yehuda",
lastname: "Katz",
url: "https://yehudakatz.com/"
}
}
Handlebars.registerHelper("link", function(text, options) { //options代表剩余所传参数
var attributes = [];
Object.keys(options.hash).forEach(key => {
var escapedKey = Handlebars.escapeExpression(key);
var escapedValue = Handlebars.escapeExpression(options.hash[key]);
attributes.push(escapedKey + '="' + escapedValue + '"');
})
var escapedText = Handlebars.escapeExpression(text);
var escapedOutput ="<a " + attributes.join(" ") + ">" + escapedText + "</a>";
return new Handlebars.SafeString(escapedOutput);
});
备注:数组.join(" ") 将数组以括号中的形式进行字符串分割
模板调用:
{{link "See Website" href=person.url class="person"}}
输出:
<a class="person" href="https://yehudakatz.com/">See Website</a>
5、如果使用与输入对象的属性相同的名称注册了助手,则该助手的优先级高于输入属性,如果出现重复情况可用this. 或 ./ 作为调用定义参数的前缀
例:
定义:
{name:"wenya"}
自定义助手
Handlebars.registerHelper('name', function () {
return "Nils"
})
模板调用:
helper: {{name}}
data: {{./name}} or {{this.name}}
6、Handlebars提供对子表达式的支持,它允许您在单个胡须内调用多个帮助程序,并将内部帮助程序调用的结果作为参数传递给外部帮助程序。子表达式用括号定界。
例:
{{outer-helper (inner-helper 'abc') 'def'}}
在这种情况下,inner-helper将使用字符串参数调用'abc',
并且inner-helper函数返回的任何内容都将作为第一个参数传递
outer-helper(并'def'作为的第二个参数传递outer-helper)。
7、~ 在大括号中添加该字符后删除改侧所有空格字符
另外补充:if else 的使用
{{#if test}}
{{title}}
{{^}}
Empty
{{/if}}