can/map/backup/doc/backup.md

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

@page can.Map.backup backup
@parent can.Map.plugins
@plugin can/map/backup
@test can/map/backup/test.html

can.Map.backup is a plugin that provides a dirty bit for properties on an Map,
and lets you restore the original values of an Map's properties after they are changed.


Here is an example showing how to use `[can.Map.backup.prototype.backup backup]` to save values,
`[can.Map.backup.prototype.restore restore]` to restore them, and `[can.Map.backup.prototype.isDirty isDirty]`

to check if the Map has changed:

```
var recipe = new can.Map({
  title: 'Pancake Mix',
  yields: '3 batches',
  ingredients: [{
    ingredient: 'flour',
    quantity: '6 cups'
  },{
    ingredient: 'baking soda',
    quantity: '1 1/2 teaspoons'
  },{
    ingredient: 'baking powder',
    quantity: '3 teaspoons'
  },{
    ingredient: 'salt',
    quantity: '1 tablespoon'
  },{
    ingredient: 'sugar',
    quantity: '2 tablespoons'
  }]
});
recipe.backup();

recipe.attr('title', 'Flapjack Mix');
recipe.title;     // 'Flapjack Mix'
recipe.isDirty(); // true

recipe.restore();
recipe.title;     // 'Pancake Mix'
```