介绍 编辑页面


英文原文:http://emberjs.com/guides/controllers/

Ember.js中,控制器用于将显示逻辑与模型绑定在一起。通常模型包含需要保存到服务器端的属性,而控制器的属性可以不需要保存至服务器端。

例如,构建博客系统时,blog_post模板用于呈现BlogPost模型。

BlogPost模型可能包含如下属性:

  • title
  • intro
  • body
  • author

blog_post模板可能会绑定这些属性到模板中去。

1
2
3
4
5
6
7
8
9
10
<h1>{{title}}</h1>
<h2>by {{author}}</h2>

<div class='intro'>
  {{intro}}
</div>
<hr>
<div class='body'>
  {{body}}
</div>

在这个简单的例子中,没有涉及任何显示相关的属性或操作。目前控制器只是作为模型的一个透明代理。(控制器其路由处理器获取到其表示的模型)。

假设现在要添加一个允许用户打开或关闭body部分的新功能。为了实现这个功能,首先需要编辑模板使其在isExpanded属性为true的时候才显示body

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<h1>{{title}}</h1>
<h2>by {{author}}</h2>

<div class='intro'>
  {{intro}}
</div>
<hr>

{{#if isExpanded}}
  <button {{action toggleProperty 'isExpanded'}}>Hide Body</button>
  <div class='body'>
    {{body}}
  </div>
{{else}}
  <button {{action toggleProperty 'isExpanded'}}>Show Body</button>
{{/if}}

body是否展开是一个明显的显示相关的逻辑,因此将其放入到模型中并不合适。

将这个属性放置到控制器中则可以将数据模型与显示相关逻辑的属性清晰的分离开。这使得可以方便的对模型进行单元测试,而完全不需要担心在测试时去考虑相关的显示逻辑。

相关性说明

Ember.js中,模板从装饰了模型的控制器中获取属性。

这就意味着模板知道控制器,而控制器知道模型,反之却不然。模型并不知道被那些控制器装饰,控制器也不知道那些视图呈现了控制器的属性。

这也意味着涉及至某个模板时,其使用的属性全部来自控制器,模板并不需要直接了解模型。

实际情况下,Ember.js在这个应用中只创建一次模板的控制器,而控制器的模型可以在应用的生命周期中随意变换,不需要视图知道模型的改变。

这样可以通过使用一个包含模板期望属性的控制器对象来独立的对模板进行测试。从模板的角度来看,控制器只是一个为其提供数据的不同对象。

代表模型

模板总是连接着控制器,而非模型。这样可以很容易的将显示相关属性与模型属性分离开。当用户在不同的页面游弋的时候,也可以很方便的置换控制器的模型。

为了方便起见,Ember.js的控制器代理了其模型的属性,因此可以在模板中使用{{name}}而非{{model.name}}来访问模型的属性。Ember.ArrayController代理了Array的属性,Ember.ObjectController则代理了一个对象的属性。

如果控制器是一个ArrayController,那么可以使用{{#each controller}}来直接遍历控制器。这样模板不需要知道控制器是如何实现的,从而使独立测试和重构变得更加简单。

保存应用属性

不是所有在应用中的属性都需要保存到服务器端。当需要只为本次运行的应用保存一些信息的时候,可以将其保存到控制器中。

例如,应用中有一个一直存在的搜索框,那么就可以在ApplicationController中存储一个search属性,并将在application模板中的搜索框绑定到该属性。

1
2
3
4
5
6
<!-- application.handlebars -->
<header>
  {{input type="text" value=search action="query"}}
</header>

{{outlet}}
1
2
3
4
5
6
7
8
9
10
11
12
App.ApplicationController = Ember.Controller.extend({
  // the initial value of the `search` property
  search: '',

  actions: {
    query: function() {
      // the current value of the text field
      var query = this.get('search');
      this.transitionToRoute('search', { query: query });
    }
  }
});

application模板保存搜索框的属性,并将其操作发送给ApplicationController。在此情形下,当用户敲回车时,应用将转换至search路由,并将查询作为参数传递。