addcollection.add(models, [options])
Add a model (or an array of models) to the collection, firing an "add" event for each model, and an "update" event afterwards. If a model property is defined, you may also pass raw attributes objects, and have them be vivified as instances of the model. Returns the added (or preexisting, if duplicate) models. Pass {at: index} to splice the model into the collection at the specified index. If you're adding models to the collection that are already in the collection, they'll be ignored, unless you pass {merge: true}, in which case their attributes will be merged into the corresponding models, firing any appropriate "change" events.
1 2 3 4 5 6 7 8 9 10 | var ships = new Backbone.Collection;ships.on("add", function(ship) { alert("Ahoy " + ship.get("name") + "!");});ships.add([ {name: "Flying Dutchman"}, {name: "Black Pearl"}]); |
Note that adding the same model (a model with the same id) to a collection more than once
is a no-op.
Please login to continue.