Handlebars基本知识

官方文档地址: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}}}

显示结果:
&amp; &lt; &gt; &quot; &#x27; &#x60; &#x3D;
& < > \ ' ` =


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}}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。