An Introduction to Handlebars(Handlebars 简介)

由于作者翻译会加入 自己的理解 以便自己学习和使用, 如果英文好的同学可看下面   如文章中有翻译错误还请留言. 交流并改正. (:

文章来自net|tuts+ 原文地址  请点击

 ======================Enein翻译=========================
 
    如果你发现你的站内信息老是定期的改变, 那么你可以尝试使用 Handlebars , Handlebars 是一个 "template processor" 模板引擎, 它会动态的生成你HTML页面. 省祛你手动更新的时间, 在这篇文章里我将介绍Handlebars, 并教你怎么为你的站点create一个简单的template.
 
Site template
为什么要让你的页面create一个模板, 这里有两个主要的原因:  
            【1】 创建模板可以使你的逻辑代码与view分离, 来接近实现  view/controller 模式.
            【2】 模板使用你的代码变得 清晰、可维护性提高.
这使得你很快就可以更新你的网站. 你不必为Handlebars设置一个站点, 只需要使用一些语法结构 这样你的网站 页面上会没有固定的数据, 下面介绍一些基础.
The Basics
    Handlebars使用template运行Json格式来生成你的页面, 这些template基本上都是HTML和一些占位和一些占位符(它允许你注入数据) 例:
这段代码是告诉用户你已经登陆:
<h1>Welcome back, {{name}}</h1>
这个{{name}} 属性是用户名称是动态注入到页面里来的. 这个占位符是使用一种类似Json结构, 这可能是最基本的例子, 但是你将看到的每一个都会基于这个简单的理念. 让我们继续看这个 "数组".
Arrays
    Handlebars中有一些内置的方法可以提供你处理复杂的数据, “each”只是其中之一, 这个标签是实现一个 iterator 来实现动态create页面. For example: 
<table>
<tr>
  <th>Local Concerts</th>
</tr>
  {{#each Concerts}}
<tr>
  <td>{{this}}</td>
</tr>
  {{/each}}
</table>
    你能看到, 这段代码比常规的代码要清晰很多, 类似使用 PHP的loop/Javascript的动态append页面. Handlebars的语法不具有 "intrusive"干扰性, 所以它是很容易理解的.  你可能不会注意到 {{this}} 意思是取出loop中当前的 element。
    这个例子, 实现数组里有简单的值还是很好的, 但是如何处理更复杂的数据? 好吧, 你基本上是做同样的事情,  例如, 我们按照下面的数据,将写一个template
[
   {
      Name : "Band",
      Date : "Aug 14th, 2012",
      Albums : [
         {
            Name : "Generic Name"
         },
         {
            Name : "Something Else!!"
         }
      ]
   },
   {
      Name : "Other Guys",
      Date : "Aug 22nd, 2012"
      Albums : [
         {
            Name : "Album One"
         }
      ]
   }
]
我们很容易使用下面的template来实现上面的数据显示:
<table>
<tr>
  <th>Band Name</th>
  <th>Date</th>
  <th>Album Name</th>
</tr>
{{#each Bands}}
<tr>
  <td>{{Name}}</td>
  <td>{{Date}}</td>
  <td>{{Albums.0.Name}}</td>
</tr>
{{/each}}
<
/table>

    在Handlebars中, 你甚至能访问内嵌属性, like in (Albums.0.Name). 当然你也可再使用一个each来loop你的数组. 你应该注意到了, 上面的例子中使用的 . 来访问属性, 你也能使用 ../ 来访问 父级的属性.

    如果数组为空没有任何数据, 你当然不希望有一个空的 table, Handlebars 很友好的提供了 if else 和 unless 语法, 这个 if ... else 在一些程序语言中都工作的很好, 如果这个Object是false或是假类型, 然后 else 将执行. 相反,  if 代码块将会执行.  这个unless是非常有意思的; 它是一个相反的if代码块, 如查表达式为 true, 这个unless块不执行. 所以让我们来加入这个方法.
{{#if Bands}}
<table>
  <tr>
    <th>Band Name</th>
    <th>Date</th>
    <th>Album Name</th>
  </tr>
  {{#each Bands}}
  <tr>
    <td>{{Name}}</td>
    <td>{{Date}}</td>
  <td>{{Albums.0.Name}}</td>
  </tr>
  {{/each}}
</table>
  {{else}}
  <h3>There are no concerts coming up.</h3>
{{/if}}
Custom Helpers
Handlebars 可以提供给你自定义这个json语法的能力. 在Handlebars里只是简单的注册一下你的Function, 然后一些template在编译的时候就可以使用你的语法. 下面的有两种类型可以让你去创建:
 
    • Function helpers 是基本的Function函数, 注册一次, 就可以在Handlebars template中的任何地方使用. Handlebars会写这个Function的回值到template上.
    • Block helpers 是类似 if , each, etc 它们允许人改变 上面文里的
  • 让我展示给你一个简单的例子. 首先, 我将会注册一个function helper 通过以下代码:
  • Handlebars.registerHelper("Max", function(A, B){
       return (A > B) ? A : B;
    });
    
    这个 registerHelper的第一个参数是这个 helper 的名子, 我将会在template里使用它. 这个第二个参数, 是一个匿名函数.
  • 如何使用请看下面的例子:
  • {{Max 12 45}}
    
    这个template 使用 Max 语法 , 和解析 12 和 45 到这个函数里, Handlebars 函数 helper里支持多个参数, 你可以直接插入数据 到template本身, 或者你能使用Json结构的属性.
    现在让我们看一下Block helper, Block helper, 允许你在代码运行前设置这个context, 例如下面这个Object:
{
   Name: "Parent",
   Sub: {
      Name: "Child"
   }
}
这里有两个key相同的Name属性, 与一个Helper来实现 即可以调用父级的Name, 又可以调用 child的Name:
Handlebars.registerHelper("BothNames", function(context, options){
   return options.fn(context) + options.fn(context.Sub);
});
template看起来像这样:
{{#BothNames this}}
  <h2>{{Name}}</h2>
{{/BothName}}

这个结束的语法名称 是告诉Handlebars这是一个block helper,和关闭它。

这个 options.fn 函数运行模板内部的块. 你可以把context传给它.
现在基础已经告一段落, 让我们来一个完整的Demo吧.
Building a Site Template
我们将使用template来构建一个食谱网站. 这将将会让你这将会让你很好的明白, Handlebars通过API取得数据和在模板中如何解析.
 
Setting up a Handlebars project
 
我们必须首先加载我们的 template script, 但为了做到这一点, 我们需要创建一个HTML文件和包含我们的Handlebars.js文件
<html>
  
<head>      
    <title>Handlebars Demo</title>    
    <script type="text/javascript" src="Handlebars.js"></script>   
  </head>  
  <body>    
    <script id="Handlebars-Template" type="text/x-handlebars-template"></script>   
  </body>
</html>
    为了简单, 你能存储你的template到<script>里和加载它通过JavaScript.这比它直接存储到JavaScript里一个变量干净多了.
现在让我们讨论这个app如何工作. 首先使这个app连接一个API去取到一些食谱信息. 下一步, 我们通过把这些信息放到Handlebars和通过template运行它. 最后, 我们通过新生成的页面把body里的内容替换掉, 它是一个相当直接的一个过程; 所以, 让我们开始在</body>之前加入第二个script代码块来初始化Ajax变量.
<script>
var Ajax = (window.XMLHttpRequest) ? new XMLHttpRequest() : new ActiveXObject("Microsoft.XMLHTTP");
Ajax.onreadystatechange = function () {  
 
if (Ajax.readyState == 4 && Ajax.status == 200) {     
  //Parse the JSON data     
  var RecipeData = JSON.parse(Ajax.responseText);      

  //Get the Template from above     
  var Source = document.getElementById("Handlebars-Template").textContent;     
  //Compile the actual Template file      

  var Template = Handlebars.compile(Source);      //Generate some HTML code from the compiled Template    
  var HTML = Template({ Recipes : RecipeData });      //Replace the body section with the new code.    
  document.body.innerHTML = HTML;   
}}

Ajax.open("GET","Recipe.php", true);
Ajax.send();
</script>

这是通过一个template去动态的编译生成html。 理论上你可以直接把Json数据放到Handlebars中, 但是你运行时会出现跨域问题。 代替的方法是使用PHP里的echo把它变为一个JavaScript的变量.所以在运行这个模板之前我会将所以的操作分到"Recipe.php"里去做. 让我们看一下这个PHP文件。

 
 Geting The Date
这个Yummly API 是相当简单, 没有身份验证系统; 你只需要注册, 取得验证信息加入到URL中,如果你想你可以通过 echo 来处理这些数据.
但我想要更详细的信息为每一个食谱, 在这之前, 我调用两个请求.
matches;
   //Cycle Through The Recipes and Get full recipe for each
   foreach($Recipes as $Recipe)
   {
      $ID = $Recipe->id;
      $R = json_decode(file_get_contents("http://api.yummly.com/v1/api/recipe/" . $ID . "?_app_id=" . $UserID . "&_app_key=" . $UserKey . "&images=large"));
      //This is the data we are going to pass to our Template
      array_push($Json, array(
         Name => $R->name,
         Ingredients => $R->ingredientLines,
         Image => $R->images[0]->hostedLargeUrl,
         Yield => $R->yield,
         Flavors => $R->flavors,
         Source => array(
            Name => $R->source->sourceDisplayName,
            Url => $R->source->sourceRecipeUrl
         )
      ));
   }
   //Print out the final JSON object
   echo json_encode($Json);
?>
下面是Handlebars template 程序, 你只需要几行代码就可以生成一个完整的网站.
<script id="Handlebars-Template" type="text/x-handlebars-template">  
 <div id="Content">    
  <h1>&Xi;RecipeCards    
    <span id='BOS'>Recipe search powered by        
      <a id='Logo' href='http://www.yummly.com/recipes'>           
        <img src='http://static.yummly.com/api-logo.png'/>       
      </a>     
    </span>    
  </h1>
  {{#each Recipes}}     
  <div class='Box'>        
    <img class='Thumb' src="{{{Image}}}" alt="{{Name}}">     
    <h3>{{Name}} <a id='Logo' href="{{Source.Url}}"> - {{Source.Name}}</a></h3>     
    <h5>{{getFlavor Flavors}}</h5>       
    <h5>{{Yield}}</h5>         
    <p>Ingredients:</p>      
    <ul>          
      {{#each Ingredients}}           
      <li>{{this}}</li>        
      {{/each}}        
    </ul>    
  </div>
    
{{/each}}  
</div>
</script>
让我们运行这段代码.  第6行只是一个Logo然后, 然后列出所有的食谱, 我们创建一个食谱卡片通过一个图片, 一个名称和一个配料.
这个Yummly API 返回味道数据. 我写一个 Function helper, 叫 getFlavor 取出味道数据到一个盘子里.为了使这个模板进行工作, 在解析template之前我们需要加载 getFlavor , 所以在Ajax Code 之前加入.
Handlebars.registerHelper("getFlavor", function(FlavorsArr){
   var H = 0;
   var Name = '';
   for(var F in FlavorsArr)
   {
      if(FlavorsArr[F] > H)
      {
         H = FlavorsArr[F];
         Name = F;
      }
   }
   return "This Dish has a " + Name + " Flavor";
});
现在, 当Handlebars解析到 getFlavor 时, 它调用相关功能和检索出味道信息.
在这点上, 你可以自由的设计你的模板. 但是你可能看到这个过程是很缓慢的. 这主要是由于这个三个请求调用是在 Handlerbars template加载之前的.显然这不是一个好的办法. 但precompiling你的template会有所帮助
 
Precompiling
你有两个不同的操作, 这第一个是预编译template, 这是为了降低加载时间, 和你将要包涵一个Handlebars compiler 到你的页面
我们的问题是 浏览器与API通信问题, 如果你想要预处理你的template, 你可以下载Node.js包 通过 npm 下面命令:
npm install handlebars -g
你可能需要 root 权限, 安装完成, 你能为你的template创建一个文件和编译它像这样
handlebars demo.handlebars -f demo.js
你可以给你的template文件一个“.handlebars”扩展名. 这不是强制的, 如果你的名称是类似 demo.html, 然后你的template文件名称是将会是"demo.html"有用部分仅仅是"demo",命名你的template后, 运行Handlebars后将内容输出到文件中,使用如下
var template = Handlebars.templates['demo'];
var html = template({ Your Json Data Here });
但是, 正如我前面所说的, 这并没有帮助我们解决问题. 我们该怎么做? 好吧, 我们能precompile和输出实体文件. 这使我们可以运行最终html的模板数据 --- 换句话说也就是 caching。
 
不幸的是. 在客户端Javascript没有文件IO功能。 所以容易做到的方法就是输出html后手动保存它. 利用API' caching ! 并确保在保存静态页面时先取得数据.
 
附录

[1] Yummly:   Yummly 是一个语义食谱搜索引擎,拥有50多万份食谱,用户可以根据口味、原料、价格、营养等搜索到所需要的食品。Yummly会根据用户过去的搜索,不断学习喜好,从而推荐可能会感兴趣的食品给你。

[2] Helper:     文章里使用的helper 是指Handlebars里有一个语法。

 
======================Enein翻译=========================
由于作者翻译会加入 自己的理解 以便自己学习和使用. 如有转载请注明出处谢谢.  如文章中有翻译错误或有更好的方案还请留言. 交流并改正. (:
posted @ 2012-11-28 18:26  Enein  阅读(8983)  评论(2编辑  收藏  举报