Handlebars expressions

Basic Usage

1,最简单的handlebars 表达式

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

使用时,会在当前context里找名为title的property,替换之。

2,handlebars表达式也可以是一个带‘.’的paths

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

该表达式会在current context里查找article属性,在result里接着找title。如果没有传article变量,页面是不能接收到值,但也不会报错(underscore这种情况会报错)。

handlebars也支持用斜杠来替换上述"."的效果。

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

3,表达式可以是任意unicode character, 除了下面这些:

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

4,handlebars的表达式的值传到模板里时会对特殊字符进行escape,如果想要传过去的html代码能够以html的形式表现效果,而不是被当做字符串显示,就要用到{{{expression}}}。

Block Helpers

1,定义一个简单的块级helper

Handlebars.registerHelper('noop', function(options) {
return options.fn(this);
});

这个noop helper 接受一个options对象,这个对象有一个fn方法,这个方法只是简单的执行模板编译和填值,它执行时会带有一个上下文,并且会返回一个字符串。

这里的this总是指向当前的上下文(使用已经编译好的模板时传入的context)。

使用 noop helper可以如下

<div class="entry">
<h1>{{title}}</h1>
<div class="body">
{{#noop}}{{body}}{{/noop}}
</div>
</div>

2,bold helper

Handlebars.registerHelper('bold', function(options) {
return new Handlebars.SafeString(
'<div style="font-weight:bold;">'
+ options.fn(this)
+'</div>'
);
})

使用

<div class="body">
{{#bold}}{{body}}{{/bold}}
</div>

生成的html代码如下

<div class="body">
<div style="font-weight:bold;">This is my first post!</div>
</div>

3,with helper

Handlebars.registerHelper('with', function(context, options) {
return options.fn(context);
});

接收#with 后面传入的参数,将其作为context传给options.fn函数,好比将#with内的部分作为子模板再传入子模板的上下文。

使用如下:

<div class="entry">
<h1>{{title}}</h1>
{{#with story}}
<div class="intro">{{{intro}}}</div>
<div class="body">{{{body}}}</div>
{{/with}}
</div>

在context的嵌套较深的时候非常有用。

Simple Iterators

4,each helper

Handlebars.registerHelper('each', function(context, options) {
var ret = ""; for(var i=0, j=context.length; i<j; i++) {
ret = ret + options.fn(context[i]);
} return ret;
});

每次执行options.fn(context[i])都对#each之间的模板进行填值并返回字符串。

5,list helper

Handlebars.registerHelper('list', function(context, options) {
var ret = "<ul>"; for(var i=0, j=context.length; i<j; i++) {
ret = ret + "<li>" + options.fn(context[i]) + "</li>";
} return ret + "</ul>";
});

使用#list会返回一个序列。当然,在定义这个helper的时候,也可以使用别的库来让代码更简洁。

比如

Handlebars.registerHelper('list', function(context, options) {
return "<ul>" + context.map(function(item) {
return "<li>" + options.fn(item) + "</li>";
}).join("\n") + "</ul>";
});

6,conditionals

简单的#if

Handlebars.registerHelper('if', function(conditional, options) {
if(conditional) {
return options.fn(this);
}
});

如果要控制结构,比如如下使用情况

{{#if isActive}}
<img src="star.gif" alt="Active">
{{else}}
<img src="cry.gif" alt="Inactive">
{{/if}}

这时就需要在条件求值返回false时候执行的模板代码

Handlebars.registerHelper('if', function(conditional, options) {
if(conditional) {
return options.fn(this);
} else {
return options.inverse(this);
}
});

暂时学到这里,后续下回再来...

上一篇:innodb的锁


下一篇:asp.net环境搭建