Backbone文档02

集合

可以在集合上监听change方法,当模型发生改变的时候,使集合的fetch获得通知。,模型触发的任何事件可以在集合上直接触发,同时可以监听集合中模型的变换。集合上代理了32个Underscore的方法,在使用时找不到,可以查看

集合相关的事件

  1. add
  2. remove
  3. reset
  4. sort

集合和模型共同的事件

  1. request
  2. sync
  3. error

集合类常用选项

  1. Backbone.Collection.extend(),使用方式Backbone.Collection.extend(properties,[classProperties])
  2. constructor/initialize,使用方式new Backbone.Collection([models],[options])
  3. model
  4. sync
  5. comparator,函数,定义排序规则。用法和sort很相似
  6. url
  • 也可以通过方法,属性获取
  1. parse
  • 每一次调用fetch从服务器拉取集合的模型数据是,parse都会被调用

集合对象常用属性方法

  1. col.models
  2. col.add(models,[options])
  • 触发集合add事件
  • 模型已存在则被忽略,需要传递options{merge:true},会适当的触发模型的change事件
  • options{at:index}将模型插入特定的index位置
  • options{sort:false}禁用添加模型时排序
  1. col.remove(models,[options])
  • 触发集合的remove事件
  1. col.reset(models,[options])
  • 使用模型列表重置集合
  • 没有参数,则将集合对象置空
  • col.fetch()也会触发reset事件
  • 在重置之前可以将旧模型列表赋值给previousModels
  1. col.set(models,[options])
  • 没有的模型将被添加,有的模型可能被修改,或者移除
  • options可以通过{add:false}{remove:false}{merge:false}将其禁用
  • 可能触发集合的add/remove事件,可能触发模型的change事件
  1. col.get(id)
  2. col.at(index)
  3. clo.push(model,[options])
  4. clo.pop([options])
  5. col.unshift(model,[options])
  6. col.shift([options])
  7. col.slice(begin,end)浅拷贝
  8. col.length模型数量
  9. col.sort([options])
  • 触发集合的sort事件
  1. col.pluck(attribute)
  • 从集合中每个模型中拉取attribute,获取属性值,组成数组
  1. col.where(attributes)
  • 返回集合中所有匹配attributes的模型数组
  1. col.findWhere(attributes)
  • 返回集合中第一个匹配attributes的模型对象
  1. col.clone()
  • 返回一个模型列表完全相同的集合新实例
  1. col.fetch()
  • 内部智能调用set方法
  • 会触发request,sync/error事件
  • 每一个新增的模型都会触发add事件,改变现有的模型会触发change事件,删除一个模型会触发remove事件
  • 不删除任何东西optionsremove:false
  • jQuery.ajax选项也可以作为fetch的选项
  1. col.create()
  • 创建成功会被添加到集合上add事件
  • 会触发requestsync/error事件
// 4. collection.reset()
 reset: function(models, options) {
      options.previousModels = this.models;
    }

你可能感兴趣的:(Backbone文档02)