Backbone.Events 是事件實作的核心,它可以讓物件擁有事件能力。
var Events = Backbone.Events = { .. }
物件透過 listenTo 偵聽其他物件,透過 trigger 觸發事件。你甚至可以脫離 Backbone 的 MVC,在自訂物件上使用事件:
var model = _.extend({}, Backbone.Events);
var view = _.extend({}, Backbone.Events);
view.listenTo(model, 'custom_event', function(){ alert('catch the event') });
model.trigger('custom_event');
Backbone 的 Model 和 View 等核心類,都是繼承自 Backbone.Events 的:
var Events = Backbone.Events = { .. }
var Model = Backbone.Model = function(attributes, options) { ... };
_.extend(Model.prototype, Events, { ... })
從原理上講,事件是這樣運作的:被偵聽的物件維護一個事件陣列 _events,其他物件在呼叫 listenTo 時,會把事件名與回呼維護到佇列中。一個事件名可以對應多個回呼,對於被偵聽者而言,只知道回呼的存在,並不知道具體是哪個物件在偵聽它。當被偵聽者呼叫 trigger(name) 時,會遍歷 _events,選擇同名事件,並把其下所有回呼執行一遍。
需要注意的是,Backbone 的 listenTo 除了讓被偵聽者維護對偵聽者的引用外,還讓偵聽者也維護了被偵聽者,這樣在恰當的時候,偵聽者可以單方面中斷偵聽。另外,若希望事件在綁定後、回呼發生一次後就解除綁定,可以使用 listenToOnce。
Backbone 預設實作了一套與 RESTful 風格伺服器端同步模型的機制。假設伺服器有如下 REST 介面:
Backbone 使用這些 HTTP 方法的地方主要有:
options 參數存在於上述方法的參數列表中,可以修改 Backbone 與 ajax 的一些行為,包括 wait(是否等待伺服器返回再更新 model)、url(覆蓋預設 url)、attrs、patch、data 等,其他參數會直接傳遞給 jQuery 的 ajax。
Backbone 透過 Model 的 urlRoot 屬性或 Collection 的 url 屬性得知伺服器介面地址。Model 的預設 url 實作如下:
url: function () {
var base = _.result(this, 'urlRoot') || _.result(this.collection, 'url') || urlError();
if (this.isNew()) return base;
return base.replace(/([^\/])$/, '$1/') + encodeURIComponent(this.id);
},
其中正則式 /([^\/])$/ 是個很巧妙的處理,它解決了 url 最後是否包含 '/' 的不確定性:匹配行尾的非 / 字元,用分組 $1 捕獲後替換為「該字元 + /」,自動補上缺失的斜線;若 url 已以 / 結尾則無法匹配,也就不需替換。
在 Backbone 中,即便一類模型實例確實在一個集合裡,也沒有強制要求使用集合類,但使用集合有一些額外好處:
url 繼承:Model 屬於 Collection 後,可以繼承 Collection 的 url 屬性。Collection 沿用了 underscore 約 90% 的集合與陣列操作,使集合操作極其方便。
var methods = ['forEach', 'each', 'map', 'collect', 'reduce', 'find', 'filter',
'reject', 'every', 'some', 'include', 'max', 'min', 'toArray', 'size',
'first', 'last', 'indexOf', 'isEmpty', 'chain', 'sample'];
// Backbone 巧妙地將這些方法附加到 Collection 中:
_.each(methods, function (method) {
Collection.prototype[method] = function () {
var args = slice.call(arguments);
args.unshift(this.models);
return _[method].apply(_, args);
};
});
自動偵聽和轉發集合中的 Model 事件:集合能自動偵聽並轉發元素事件,例如監聽到元素的 destroy 事件後自動移除並引發 remove 事件;監聽到 id 改變後自動更新內部引用。
自動模型構造:利用 Collection 的 fetch 可以載入伺服器資料集合,並自動建立相關 Model 實例。
元素重複判斷:Collection 會根據 Model 的 idAttribute 指定的唯一鍵判斷元素是否重複,預設唯一鍵是 id。
模型轉化:可透過 Model.parse 或 Collection.parse 在實例化前對資料預處理。
// 只挑選 type=1 的 book
var Books = Backbone.Collection.extend({
parse: function(models, options){
return _.filter(models, function(model){
return model.type == 1;
});
}
});
Backbone 的視圖物件十分簡單,對開發者而言,僅需關心一個 el 屬性。el 可以透過五種途徑給出,優先級從高到低:
事件機制帶來了代碼維護的便利,但由於事件綁定會讓物件間的引用變得複雜,容易造成記憶體洩漏。例如下面這種寫法:在 render 中簡單粗暴地清空 DOM,之前實例化的 TaskView 物件並不會被釋放,導致每次排序都新增一批視圖物件,記憶體不斷上漲。
改進的辦法是:用一個 views 陣列追蹤新建的 TaskView,在 render 時依次呼叫它們的 remove(),然後清空陣列,這樣舊視圖就變成沒有任何被引用的不可達物件,垃圾回收器便能回收它們。
var TaskCollectionView = Backbone.View.extend({
initialize: function(){
this.listenTo(this.collection, 'add', this.addOne);
this.listenTo(this.collection, 'reset', this.render);
this.views = []; // 追蹤建立的 view
},
addOne: function(task){
var view = new TaskView({ model: task });
this.$el.append(view.render().$el);
this.views.push(view);
},
render: function(){
var _this = this;
_.each(this.views, function(view){
view.remove().off(); // 解除事件偵聽
});
this.views = [];
this.$el.empty();
this.collection.each(function(model){ _this.addOne(model); });
return this;
}
});
Backbone 的 View 有一個 remove 方法,它除了刪除 View 關聯的 DOM 物件,還會阻斷事件偵聽——透過 listenTo 時記錄下來的被偵聽物件,讓它們刪除對自己的引用,內部使用 stopListening 完成。此外再呼叫 off,把視圖可能被外部偵聽的部分也一併斷開。
自訂事件比較適合多人協作開發,因為函式名若相同,後者會覆蓋前者,而事件在綁定的情況下不會被覆蓋。
var Mod = Backbone.Model.extend({
defaults: { name: 'trigkit4' },
initialize: function(){
this.on('change', function(){
alert(123);
});
}
});
var model = new Mod;
model.set('name', 'backbone'); // 資料改變,彈出 123
object.on(event, callback, [context]) 用於綁定一個回呼函式到物件上,當事件觸發時執行回呼。你也可以自訂要綁定的被改變資料型別,如 change:age:
var Mod = Backbone.Model.extend({
defaults: { name: 'trigkit4', age: 21 },
initialize: function(){
this.on('change:age', function(){
alert(123);
});
}
});
$(function(){
var Mod = Backbone.Model.extend({ defaults: { name: 'trigkit4' } });
var V = Backbone.View.extend({
initialize: function(){
this.listenTo(this.model, 'change', this.show);
},
show: function(model){
$('body').append('<div>' + model.get('name') + '</div>');
}
});
var m = new Mod;
var v = new V({model: m});
m.set('name', 'hello'); // 觸發事件,頁面隨之更新
});
var Workspace = Backbone.Router.extend({
routes: {
"help": "help",
"search/:query": "search",
"search/:query/p:page": "search"
},
help: function(){ alert(123); },
search: function(query, page){ alert(345); }
});
var w = new Workspace;
Backbone.history.start(); // 透過 hash 值找到對應的回呼函式
格式為:事件 + 空格 + 由誰來觸發 : 對應的回呼函式。
$(function(){
var V = Backbone.View.extend({
el: $('body'),
events: {
"click input": "hello",
"mouseover li": "world"
},
hello: function(){ alert(1234); },
world: function(){ alert(123); }
});
var view = new V;
});