Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: 53a4efe2d1
Fetching contributors…

Cannot retrieve contributors at this time

90 lines (63 sloc) 2.214 kb

backbone-deep-model

Improved support for models with nested attributes.

Allows you to get and set nested attributes with path syntax, e.g. user.type.

Triggers change events for changes on nested attributes.

Dependencies

Backbone >= 0.9.2

Usage

To install, include the src/backbone-deep-model.js file in your HTML page, after Backbone and it's dependencies.

Then just have your models extend from Backbone.DeepModel instead of Backbone.Model.

Example code:

//Create models with nested attributes
var model = new Backbone.DeepModel({
    id: 123,
    user: {
        type: 'Spy',
        name: {
            first: 'Sterling',
            last: 'Archer'
        }
    },
    otherSpies: {
        { name: 'Lana' },
        { name: 'Cyrril' }
    }
});

//You can bind to change events on nested attributes
model.bind('change:user.name.first', function(model, val) {
    console.log(val);
});

//Use set with a path name for nested attributes
//NOTE you must you quotation marks around the key name when using a path
model.set({
    'user.name.first': 'Lana',
    'user.name.last':  'Kang'
});

//Use get() with path names so you can create getters later
console.log(model.get('user.type'));    // 'Spy'

//You can use index notation to fetch from arrays
console.log(model.get('otherSpies.0.name')) //'Lana'

Author

Charles Davison - powmedia

Contributors

Changelog

0.7.4:

  • Fix: #22 model.hasChanged() is not reset after change event fires
  • Fix: #18 Setting a deep property to the same value deletes the property (mikefrey)
  • Allow setting nested attributes inside an attribute whose value is currently null (sqs)

0.7.3:

  • Add DeepModel.keyPathSeparator to allow using custom path separators

0.7.2:

  • Check if the child object exists, but isn't an object. #12 (tgriesser)

0.7.1:

  • Model.changedAttributes now works with nested attributes.
  • Fix getting attribute that is an empty object

0.7:

  • Update for Backbone v0.9.2
Jump to Line
Something went wrong with that request. Please try again.