英文原文: http://emberjs.com/guides/templates/rendering-with-helpers/

Ember.js提供了数个助手来协助你以不同的方式来渲染其他视图或模板

{{partial}} 助手

{{partial}}接收一个模板作为其参数,然后恰当地渲染这个模板

{{partial}}不改变上下文或作用域。它只是简单地在当前作用域下将指定的模板渲染出来。

  1. <script type="text/x-handlebars" data-template-name='_author'>
  2. Written by {{author.firstName}} {{author.lastName}}
  3. </script>
  4. <script type="text/x-handlebars" data-template-name='post'>
  5. <h1>{{title}}</h1>
  6. <div>{{body}}</div>
  7. {{partial "author"}}
  8. </script>
  1. <div>
  2. <h1>Why You Should Use Ember.JS</h1>
  3. <div>Because it's awesome!</div>
  4. Written by Yehuda Katz
  5. </div>

Partial的data-template-name必须以下划线开头(例如:data-template-name='_author'或者data-template-name='foo/_bar'

{{view}} 助手

此助手和 partial 类似,不同的是你需要提供一个视图类,而不是在当前模板内提供一个待渲染的模板。这个视图类控制哪个模板将被渲染,如下所示:

  1. App.AuthorView = Ember.View.extend({
  2. // We are setting templateName manually here to the default value
  3. templateName: "author",
  4. // A fullName property should probably go on App.Author,
  5. // but we're doing it here for the example
  6. fullName: (function() {
  7. return this.get("author").get("firstName") + " " + this.get("author").get("lastName");
  8. }).property("firstName","lastName")
  9. })
  1. <script type="text/x-handlebars" data-template-name='author'>
  2. Written by {{view.fullName}}
  3. </script>
  4. <script type="text/x-handlebars" data-template-name='post'>
  5. <h1>{{title}}</h1>
  6. <div>{{body}}</div>
  7. {{view App.AuthorView}}
  8. </script>
  1. <div>
  2. <h1>Why You Should Use Ember.JS</h1>
  3. <div>Because it's awesome!</div>
  4. Written by Yehuda Katz
  5. </div>

当使用 {{partial "author"}} 时:

  • 不会创建 App.AuthorView 的实例
  • 会渲染指定模板

当使用 {{view App.AuthorView}} 时:

  • 会创建 App.AuthorView 的实例
  • 会渲染与指定视图相关联的模板(默认的模板是 “author”)

更多信息,请见在模板中插入视图

{{render}} 助手

{{render}} 需要两个参数:

  • 第一个参数描述需要建立的上下文
  • 第二个参数是可选参数,它接收一个模型,如果提供了这个参数,就会被传递给控制器。

{{render}} 可以完成以下几个功能:

  • 如果没有提供model,那么将使用对应controller的单例实例
  • 如果提供了model,那么将使用对应controller的一个独立实例
  • 用此控制器渲染命名模板
  • 设置相应控制器的模型

稍微修改一下 post / author 的例子:

  1. <script type="text/x-handlebars" data-template-name='author'>
  2. Written by {{firstName}} {{lastName}}.
  3. Total Posts: {{postCount}}
  4. </script>
  5. <script type="text/x-handlebars" data-template-name='post'>
  6. <h1>{{title}}</h1>
  7. <div>{{body}}</div>
  8. {{render "author" author}}
  9. </script>
  1. App.AuthorController = Ember.ObjectController.extend({
  2. postCount: function() {
  3. return App.Post.countForAuthor(this.get("model"));
  4. }.property("model","App.Post.@each.author")
  5. })

在此例中,render 助手会:

  • 如果 App.AuthorView 存在,获取它的一个实例,否则就使用默认生成的视图
  • 使用相应的模板(此处为默认的 “author”)
  • 获取(或生成)AuthorController 的单体实例
  • 设置 AuthorController的模型为{{render}}助手的第二个参数,此处为 post 里的 author 字段
  • 根据前几步创建的上下文,恰当地渲染模板

{{render}} 不需要匹配路由。

{{render}}{{outlet}} 类似。两者均负责通知Ember.js将这一部分页面用来渲染其他模板。

{{outlet}}: 路由器决定路由,并且创建合适的控制器/视图/模型 {{render}}: 你(直接或间接地)指定合适的控制器/视图/模型

注意:当没有指定模型时,同一个路由不能重复的调用{{render}}

比较表

整体概念性比较

助手 模板 模型 视图 控制器
{{partial}} 指定模板 当前模型 当前视图 当前控制器
{{view}} 视图的模板 当前模型 指定视图 当前控制器
{{render}} 视图的模板 指定模型 指定视图 指定控制器

Specific

基于特定实例的比较

助手 模板 模型 视图 控制器
{{partial “author”}} author.hbs Post App.PostView App.PostController
{{view App.AuthorView}} author.hbs Post App.AuthorView App.PostController
{{render “author” author}} author.hbs Author App.AuthorView App.AuthorController