【原创】backbone1.1.0源码解析之View

作为MVC框架，M(odel) V(iew) C(ontroler)之间的联系是必不可少的，今天要说的就是View（视图）

通常我们在写逻辑代码也好或者是在ui组件也好，都需要跟dom打交道，我们好讨厌在逻辑代码里面参杂dom的代码，特别是需要生产dom的代码，

因为这样的缺点：

1. 耦合，难于维护（虽然模版引擎能解决一些问题，但是事件的添加呢？）

2. 代码无法做到美观，节俭，感觉和dom参杂在一起就是一个字，乱！！

介于这样的缺点，Backbone提供了一个View类，用于构造对象，它可以做到一下几点：

1. 帮你创建dom，你只要负责去渲染这个dom就行了（我们用模板引擎就行dom的渲染就很合理）

2. 帮你为dom添加（代理）事件，所以无需自己去手动绑定事件啦，而只需要提供events的参数。

这样下来，上面的两个缺点基本都解决了～～

View(视图)

视图对象用来封装前端的dom元素，也就是说跟dom元素关联在一起，视图的改变即是对应dom元素的改变。

因此我们在创建视图类或者在构造视图对象的时候，我们需要传递dom元素，我们可以这样：

1. 构造视图对象时，传递el参数，可以是jquery对象，也可以是dom对象（前提是该dom元素在页面里面已存在）

var bookView = new Backbone.View({
el : $('#id')    // jquery对象，或dom对象
});

而接下来我们要做的就只是往这个dom元素里添加内容了，像这样：

initialize : function () {

var tpl ='xxx';
var data = {...};

this.$el.html(_.template(tpl, data));
}

这里我们更建议你去使用_.template这样的的模板函数就渲染dom，会显得代码更节俭，美观

2. 创建视图类时，传递tagName（默认是div），让View来帮你创建dom元素

var BookView = Backbone.View.extend({

tagName : 'span'
});
var bookView = new BookView({
attributes : {
'title' : 'xxx'  // span的标签的属性
},

id : 'demo'
});

记住最后render时要将这个元素append到页面里面去，因为这里的dom元素是通过tagName，Backbone在内部创建的，并未添加到文档流中去。

说到dom元素，当然就有事件，向click，hover等事件是必不可少的，有了事件才有了交互，有了交互才会有数据（model）的变化才会有dom（view）的更新。

所以接下来要说一下如何给已有dom添加事件

1. 在创建视图类的时候，可以通过events参数添加事件，像这样：

var BookView = Backbone.View.extend({

tagName : 'span'，

events : {

'mouseenter' : function () {...},  // 事件，某一函数（this对象指向view实例）

'click a.item' : 'say'  // 事件代理,为class为item的a标签代理，调用view对象的say方法

},

say : function () {
console.log(this);
}
});

注意：

（1）Backbone的事件都是添加在视图关联的那个dom元素（el）上，那么该元素就有可能成为其子元素的事件代理元素（冒泡原理）

（2）事件的回调函数中的this是该视图对象

（3）'click a.item' 这里是一个事件代理，

（4）回调函数如果不是函数，是字符串，那么会到view对象中获取对应的方法，想这里的say其实是viewObj.say

2. 当然我们也可以通过调用delegateEvents方法添加事件，像这样：

var bookView = new BookView(...);

bookView.delegateEvents({

'click' : function () {...},

'click a.item' : 'say'
});

但是这里要注意的是：每次调用这个方法，前面添加的事件会被先清除

Backbone是如何更新视图的呢？

很明显，视图还会关联一个model实例，通过监听model实例的变化，从而相应的更新视图

这里是一个简单的小例子：

首先，我们在initialize函数中，要求view实例监听model实例的change事件

然后，在回调函数中将model，change后的状态表现出来，这里是model的price属性变化了

var BookModel = Backbone.Model.extend();

var BookView = Backbone.View.extend({

tagName : 'span',

initialize : function () {

this.listenTo(this.model, 'change', this._change);
　　　　　　　this.$el.html(this.model.get('price'));
$('body').append(this.$el);
},

_change : function (model) {

this.$el.html('更新：' + model.get('price'));
}
});

var bookModel = new BookModel({
price : 10
});

var bookView = new BookView({

model : bookModel,

attributes : {
'title' : 'span'
},

id : 'demo'
});

setTimeout(function () {
bookModel.set('price', 30);
}, 1000);

例子在这：demo

当然，这里只是简单演示一下，其实，一般最后的bookModel.set('price', 30)，都是用户通过交互来做到的，也就是说这段代码应该在

dom的事件函数中表现出来，于是我们就可以为dom添加对应的事件了

ok，接下来把源码解析的中文注释附上，如果错误了，还望指出来，谢谢～～

// Backbone.View
// -------------

// Backbone Views are almost more convention than they are actual code. A View
// is simply a JavaScript object that represents a logical chunk of UI in the
// DOM. This might be a single item, an entire list, a sidebar or panel, or
// even the surrounding frame which wraps your whole app. Defining a chunk of
// UI as a **View** allows you to define your DOM events declaratively, without
// having to worry about render order ... and makes it easy for the view to
// react to specific changes in the state of your models.

// Creating a Backbone.View creates its initial element outside of the DOM,
// if an existing element is not provided...
var View = Backbone.View = function(options) {

// 实例唯一id
this.cid = _.uniqueId('view');

options || (options = {});

// 从options里挑出存在于viewOptions里的有意义的属性值，
// 并赋值到this里对象里，作为属性
_.extend(this, _.pick(options, viewOptions));

// view是跟dom有关的
// 所以这里要先确定dom元素是否指定
this._ensureElement();

// 初始化，一般用户来自定义
this.initialize.apply(this, arguments);

// 添加（代理）事件
this.delegateEvents();
};

// Cached regex to split keys for `delegate`.
// 在添加事件时，分开事件名和选择器
var delegateEventSplitter = /^(\S+)\s*(.*)$/;

// List of view options to be merged as properties.
// 将可能作为view实例的一些属性名（由用户传入）
var viewOptions = ['model', 'collection', 'el', 'id', 'attributes', 'className', 'tagName', 'events'];

// Set up all inheritable **Backbone.View** properties and methods.
// 原型方法
_.extend(View.prototype, Events, {

// The default `tagName` of a View's element is `"div"`.
// 用于构造dom元素，默认是div元素i，用户可以传递参数覆盖
tagName: 'div',

// jQuery delegate for element lookup, scoped to DOM elements within the
// current view. This should be preferred to global lookups where possible.
// 将对元素的查找缩小到与试图关联的dom元素($el)内，提高效率
$: function(selector) {
return this.$el.find(selector);
},

// Initialize is an empty function by default. Override it with your own
// initialization logic.
// 初始化函数，一般用户自定义覆盖
initialize: function(){},

// **render** is the core function that your view should override, in order
// to populate its element (`this.el`), with the appropriate HTML. The
// convention is for **render** to always return `this`.
// 渲染函数，用来填充视图关联的dom元素（$el）
// 用户自定义覆盖之
// 注意：建议使用模板引擎对处理html，例如已有的_.template()
render: function() {
return this;
},

// Remove this view by taking the element out of the DOM, and removing any
// applicable Backbone.Events listeners.
// 将视图关联的dom元素删除
// 停止该视图对象的所有的事件监听（一般view视图会监听model的变化，从而相应地更新视图）
remove: function() {
this.$el.remove();
this.stopListening();
return this;
},

// Change the view's element (`this.el` property), including event
// re-delegation.
// 设置与视图关联的dom元素（$el）
setElement: function(element, delegate) {

// 删除之前的$el的事件监听
if (this.$el) this.undelegateEvents();

// dom对象还是jquery对象的判断，统一转换成jquery对象，赋值给$el
this.$el = element instanceof Backbone.$ ? element : Backbone.$(element);

// 将dom对象赋值给el
this.el = this.$el[0];

// 是否添加事件
if (delegate !== false) this.delegateEvents();
return this;
},

// Set callbacks, where `this.events` is a hash of
//
// *{"event selector": "callback"}*
//
//     {
//       'mousedown .title':  'edit',
//       'click .button':     'save',
//       'click .open':       function(e) { ... }
//     }
//
// pairs. Callbacks will be bound to the view, with `this` set properly.
// Uses event delegation for efficiency.
// Omitting the selector binds the event to `this.el`.
// This only works for delegate-able events: not `focus`, `blur`, and
// not `change`, `submit`, and `reset` in Internet Explorer.
// 给视图关联的dom元素添加事件或者是给它的子元素添加代理事件
delegateEvents: function(events) {

// 参数events为空，则用this.events代替
if (!(events || (events = _.result(this, 'events')))) return this;

// 在调用时，会先去除之前的所有的事件监听
this.undelegateEvents();

// 遍历events对象
for (var key in events) {

// method为方法名（字符串）或者函数
var method = events[key];

// 如果不是函数（即是字符串），那么表示调用的是view对象对应名字的方法
if (!_.isFunction(method)) method = this[events[key]];

// 如果方法为空，跳过
if (!method) continue;

// 匹配出事件名(eventName)和选择器(selector)
var match = key.match(delegateEventSplitter);
var eventName = match[1], selector = match[2];

// 将方法的this对象指定为该视图对象
method = _.bind(method, this);

// 修改事件名，添加命名空间，便于以后事件的删除
// .delegateEvents用于区分其他程序在同一个dom元素上绑定的事件
// cid用于区分不同的视图对象共享同一个dom元素
eventName += '.delegateEvents' + this.cid;

// 如果选择器为空，为视图关联的这个dom元素绑定事件
if (selector === '') {
this.$el.on(eventName, method);

// 如果选择器不为空，则为dom元素下匹配selector的子元素绑定代理事件
} else {
this.$el.on(eventName, selector, method);
}
}
return this;
},

// Clears all callbacks previously bound to the view with `delegateEvents`.
// You usually don't need to use this, but may wish to if you have multiple
// Backbone views attached to the same DOM element.
// 删除绑定的所有（代理）事件
undelegateEvents: function() {
this.$el.off('.delegateEvents' + this.cid);
return this;
},

// Ensure that the View has a DOM element to render into.
// If `this.el` is a string, pass it through `$()`, take the first
// matching element, and re-assign it to `el`. Otherwise, create
// an element from the `id`, `className` and `tagName` properties.
// 确保视图有关联的dom元素
// 如果没有，试图通过tagName构造
_ensureElement: function() {

// 如果构造时没有传递了el参数
// 那么，用tagName参数构造dom元素，并为该dom元素添加一系列的属性（参数传进来来的）
if (!this.el) {

// 将要添加到dom元素上的属性列表
// 注意：attributes可以是函数，这样可以通过条件判断返回不同的属性
// 下面的id，className，tagName，el同样是这样，都通过调用_.result
var attrs = _.extend({}, _.result(this, 'attributes'));

// dom元素id
if (this.id) attrs.id = _.result(this, 'id');

// dom元素class
if (this.className) attrs['class'] = _.result(this, 'className');

// 生成dom元素
var $el = Backbone.$('<' + _.result(this, 'tagName') + '>').attr(attrs);

// 设置dom元素
this.setElement($el, false);
} else {

// 设置dom元素
this.setElement(_.result(this, 'el'), false);
}
}

});