can/model/doc/model_bind.md

MIT-licensed, client-side, JavaScript framework that makes building rich web applications easy.

@description Listen to events on this Model.
@function can.Model.prototype.bind bind
@parent can.Model.prototype
@signature `model.bind(eventName, handler)`
@param {String} eventName The event to bind to.
@param {function} handler The function to call when the
event occurs. __handler__ is passed the event and the
Model instance.
@return {can.Model} The Model, for chaining.

@body
`bind(eventName, handler(ev, args...) )` is used to listen
to events on this model instance.  Example:

```
Task = can.Model.extend()
var task = new Task({name : "dishes"})
task.bind("name", function(ev, newVal, oldVal){})
```

Use `bind` the
same as [can.Map::bind] which should be used as
a reference for listening to property changes.

Bind on model can be used to listen to when
an instance is:

- created
- updated
- destroyed

like:

```
Task = can.Model.extend()
var task = new Task({name : "dishes"})

task.bind("created", function(ev, newTask){
 console.log("created", newTask)
})
.bind("updated", function(ev, updatedTask){
 console.log("updated", updatedTask)
})
.bind("destroyed", function(ev, destroyedTask){
 console.log("destroyed", destroyedTask)
})

// create, update, and destroy
task.save(function(){
 task.attr('name', "do dishes")
     .save(function(){
       task.destroy()
     })
});
```

`bind` also extends the inherited
behavior of [can.Map::bind] to track the number
of event bindings on this object which is used to store
the model instance.  When there are no bindings, the
model instance is removed from the store, freeing memory.