Backbone.js为复杂WEB应用程序提供模型(models)、集合(collections)、视图(views)的结构。其中模型用于绑定键值数据和自定义事件;集合附有可枚举函数的丰富API; 视图可以声明事件处理函数,并通过RESRful JSON接口连接到应用程序。
Backbone.Events(事件)
事件绑定on object.on(event, callback, [context])
别名: bind 在 object 上绑定一个callback回调函数。 只要event触发,该回调函数就会调用。
事件监听
//监听事件 var person = Backbone.Model.extend({ defaults: { name: 'lbs', sex: 'man', age: 10 } }) var me = new person()
监听-默认属性
// 监听-默认属性 me.on('change',function(){ console.log( '对象默认属性的值改变了' ) }) me.set({name:'ccx'})
监听-指定属性
// 监听-指定属性 me.on('change:age',function(model,value){ console.log( '年龄改变了,现在是'+ value ) }) me.set({age:20})
监听- 修改前的属性值
// 监听- 修改前的属性值 1 me.on('change:sex',function(model,value){ var oldsex = model.previous('sex'); console.log( '性别改变了,以前是'+ oldsex +' 现在是'+ value ) }) me.set({sex: 'woman'}) // 监听- 修改前的属性值 2 me.on('change:age',function(model,value){ var attrs = model.previousAttributes(); var oldage = attrs.age; if(oldage < value){ console.log( '年龄增加了! ' + '以前是'+ oldage +' 现在是'+ value) }else if(oldage > value){ console.log( '年龄减少了! ' + '以前是'+ oldage +' 现在是'+ value) } }) me.set({age: 50}) me.set({age: 6})
监听- 多个事件 属性
// 监听- 多个事件 属性 me.on('change:age change:sex change:name',function(model,value){ var attrs = model.previousAttributes(); var oldage = attrs.age; var oldsex = attrs.sex; var oldname = attrs.name; var newage = model.get('age'); var newsex = model.get('sex'); var newname = model.get('name'); if( oldage !== newage ){ console.log( '年龄改变了! ' + '以前是'+ oldage +' 现在是'+ newage) } if( oldsex !== newsex ){ console.log( '性别改变了! ' + '以前是'+ oldsex +' 现在是'+ newsex) } if( oldname !== newname ){ console.log( '姓名改变了! ' + '以前是'+ oldname +' 现在是'+ newname) } }) me.set({age: 100}) me.set({sex: 'boy'}) me.set({name: 'rmb'}) // 监听- 多个事件 属性 2 var name_change = function(model,value){ var oldname = model.previous('name'); var newname = model.get('name'); if( oldname !== newname ){ console.log( '姓名改变了! ' + '以前是'+ oldname +' 现在是'+ newname) } }, age_change = function(model,value){ var oldage = model.previous('age'); var newage = model.get('age'); if( oldage !== newage ){ console.log( '年龄改变了! ' + '以前是'+ oldage +' 现在是'+ newage) } }, sex_change = function(model,value){ var oldsex = model.previous('sex'); var newsex = model.get('sex'); if( oldsex !== newsex ){ console.log( '性别改变了! ' + '以前是'+ oldsex +' 现在是'+ newsex) } }, events = { 'change:name': name_change, 'change:age': age_change, 'change:sex': sex_change }; me.on(events); me.set({name:'ccx', age:50, sex:'woman'})
事件绑定once object.once(event, callback, [context]) 用法跟on很像,区别在于绑定的回调函数触发一次后就会被移除。
var person = Backbone.Model.extend({ defaults: { name: 'lbs', sex: 'man', age: 10 } }) var me = new person() var num = 0 me.once('change',function(){ console.log( '事件触发次数为:'+ ++num ) }) me.set({name: 'ccx'}) // 事件触发次数为:1 me.set({sex: 'woman'})
触发事件trigger object.trigger(event, [*args])
触发给定 event或用空格隔开的事件的回调函数。后续传入 trigger 的参数会传递到触发事件的回调函数里。
var person = Backbone.Model.extend({ defaults: { name: 'lbs', sex: 'man', age: 10 } }) var me = new person() me.on('changeage',function(){ console.log( '手动触发自定义事件') }) me.on('change:age',function(model,value){ if(value !== undefined){ console.log('自动触发系统事件,现在的年龄为 '+ value) }else{ console.log('手动触发系统事件') } }) me.trigger('changeage') //手动触发自定义事件 me.trigger('change:age') //手动触发系统事件 me.set({age: 150}) //自动触发系统事件,现在的年龄为 150
移除事件off object.off([event], [callback], [context])
别名: unbind 从 object 对象移除先前绑定的 callback 函数。如果没有指定context(上下文),所有上下文下的这个回调函数将被移除。如果没有指定callback,所有绑定这个事件回调函数将被移除;如果没有指定event,所有事件的回调函数会被移除。
// Removes just the `onChange` callback. object.off("change", onChange); // Removes all "change" callbacks. object.off("change"); // Removes the `onChange` callback for all events. object.off(null, onChange); // Removes all callbacks for `context` for all events. object.off(null, null, context); // Removes all callbacks on `object`. object.off();
事件监听listenTo object.listenTo(other, event, callback)
让 object 监听 另一个(other)对象上的一个特定事件。不使用other.on(event, callback, object),而使用这种形式的优点是:listenTo允许 object来跟踪这个特定事件,并且以后可以一次性全部移除它们。callback总是在object上下文环境中被调用。
view.listenTo(model, 'change', view.render); 等价于 model.on('change',view.render,view) var person = Backbone.Model.extend({ defaults: { name: 'lbs', sex: 'man', age: 10 } }) var me = new person() var ta = _.extend({}, Backbone.Events) ta.listenTo(me,'change:age',function(model,value){ var oldage = model.previous('age'); console.log( '年龄改变了,以前是'+ oldage +' 现在是'+ value ) }) me.set({'age':80}) //年龄改变了,以前是10 现在是80
listenToOnce object.listenToOnce(other, event, callback)
用法跟 listenTo 类似,但是事件触发一次后callback将被移除。
停止监听事件stopListening object.stopListening([other], [event], [callback])
让 object 停止监听事件。如果调用不带参数的stopListening,可以移除 object 下所有已经registered(注册)的callback函数...,或者只删除指定对象上明确告知的监听事件,或者一个删除指定事件,或者只删除指定的回调函数。
view.stopListening(); view.stopListening(model); view.stopListening(model,'change'); view.stopListening(model,'change',view.render);
特殊事件all
var person = Backbone.Model.extend({ defaults: { name: 'lbs', sex: 'man', age: 10 } }) var me = new person() me.on('change:age',function(){ console.log( '触发了change:age事件') }) me.on('change:name',function(){ console.log('触发了change:name事件') }) me.on('all', function (value) { console.log('触发了all事件中' + value) }) me.set('name','ccx') me.set('age', 50) //me.trigger('all')
Backbone 内置事件列表
Backbone内置事件的完整列表,带有参数,可以在Models(模型),Collection(集合),Views(视图)上自由地触发这些事件。
一般来说,事件触发(例如 model.set,collection.add 或者其他事件)后就会执行回调函数,但是如果想阻止回调函数的执行,可以传递 {silent: true} 作为参数。
"add" (model, collection, options) — 当一个model(模型)被添加到一个collection(集合)时触发。 "remove" (model, collection, options) — 当一个model(模型)从一个collection(集合)中被删除时触发。 "reset" (collection, options) — 当该collection(集合)的全部内容已被替换时触发。 "sort" (collection, options) — 当该collection(集合)已被重新排序时触发。 "change" (model, options) — 当一个model(模型)的属性改变时触发。 "change:[attribute]" (model, value, options) — 当一个model(模型)的某个特定属性被更新时触发。 "destroy" (model, collection, options) —当一个model(模型)被destroyed(销毁)时触发。 "request" (model_or_collection, xhr, options) — 当一个model(模型)或collection(集合)开始发送请求到服务器时触发。 "sync" (model_or_collection, resp, options) — 当一个model(模型)或collection(集合)成功同步到服务器时触发。 "error" (model_or_collection, resp, options) — 当一个model(模型)或collection(集合)的请求远程服务器失败时触发。 "invalid" (model, error, options) — 当model(模型)在客户端 validation(验证)失败时触发。 "route:[name]" (params) — 当一个特定route(路由)相匹配时通过路由器触发。 "route" (route, params) — 当任何一个route(路由)相匹配时通过路由器触发。 "route" (router, route, params) — 当任何一个route(路由)相匹配时通过history(历史记录)触发。 "all" — 所有事件发生都能触发这个特别的事件,第一个参数是触发事件的名称。