作为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);
}
} });