Handlebars学习之——表达式

Handlebars表达式是Handlebars模板的基本单元，可以单独在{{mustache}}中使用它，将它们传入Handlebars helper，或将它们作为hash arguments的值使用

基本使用

<h1>{{title}}</h1>

这个表达式的意思是：在当前上下文中查找title属性

Handlebars也可以使用.来分隔标识符，这类表达式被称为path

<h1>{{article.title}}</h1>

这个表达式的意思是：在当前上下文中查找article属性，并在查找结果中查找title属性

也支持用/来分隔，但不推荐使用

标识符可以是任何Unicode编码的字符，除了：

空格 ! " # % & ' ( ) * + , . / ; < = > @ [ \ ] ^ ` { | } ~

要引用一个不是合法标识符的属性，可以用方括号[，如：

{{#each articles.[10].[#comments]}}  <h1>{{subject}}</h1>  <div>    {{body}}  </div>{{/each}}

上述articles.[10].[#comments]相当于JavaScript中的articles[10]['#comments']

当使用{{expression}}时，handlebars会转义其中的html内容，而使用{{{expression}}}时不会转义

Handlebars.registerHelper('link', function(str){    return '<span>'+ str +'</span>';});{{link 'hello'}}  //<span>hello</span>{{{link 'hello'}}}  //hello

Helpers

handlebars helper相当于一个函数，先在js代码中注册一个helper：

Handlebars.registerHelper('link', function(str){  return '<span>'+ str +'</span>';});

然后在模板文件中调用helper，第一个标识符为注册的helper的名称，在本例中为”link”，后面跟着helper回调函数的参数，可以是0个或多个，用空格隔开

{{{link 'hello'}}}

此外，handlebars还可以接收一些可选的键值对序列作为helper回调函数最后一个参数的值（这在Handlebars中被称为hash arguments）。
hash arguments的key是一个普通的标识符，value则是一个Handlebars表达式，因此可以是标识符、path或字符串

模板文件中：

{{{hash 'hello' href='world'}}}

handlebars.registerHelper('hash', function(str, options){  console.log(options.hash);});

输出

{ href: 'world' }

子表达式

Handlebars支持子表达式，可以在一个mustache中调用多个helper，内层helper的返回结果将作为外层helper的参数传递

{{outer-helper (inner-helper 'abc') 'def'}}

控制空白

当在mustache语句的两侧使用~符号，可以去除那一侧的所有空白，直到遇到非空白字符或第一个handlebars表达式

示例：

上下文：

{  nav: [    {url: 'foo', test: true, title: 'bar'},    {url: 'bar'}  ]}

下列模板代码：

{{#each nav}}  <a href="{{url}}">    {{#if test}}      {{title}}    {{^}}      Empty    {{/if}}  </a>{{~/each}}

会输出：

<a href="foo">    bar</a><a href="bar">    Empty</a>

使用~去除空白：

{{#each nav ~}}  <a href="{{url}}">    {{~#if test}}      {{~title}}    {{~^~}}      Empty    {{~/if~}}  </a>{{~/each}}

输出：

<a href="foo">bar</a><a href="bar">Empty</a>

转义

这边说的转义并不是指html转义，而是输出模板语句，如直接输出{{title}}而不是输出title

Handlebars有两种转义方式：

• inline escapes
• raw blocks

inline escapes就是在mustache区块之前加一个反斜杠\

\{{escaped}}

raw blocks是用四个大括号{{{{将要转义的区块围住来进行转义

{{{{raw}}}}  {{escaped}}{{{{/raw}}}}

然后还要写一个helper：

handlebars.registerHelper('raw', function(options) {  return options.fn();});

(这么多花括号看得眼睛都花了…)

参考

• Handlebars.js: Minimal Templating on Steroids