Skip to content

gmurphey/backbone.customsync

Repository files navigation

Backbone.CustomSync

Build Status Gittip

Backbone.CustomSync is a Backbone.js plugin that allows you to write custom methods for all sync procedures ("read", "create", "update", and "delete"), or only those that you define.

Features

  • AMD, CommonJS and Global compliant
  • Compatible with promise-based syncing
  • Preserves original sync functionality with an xhrSync method

Getting Started

Backbone.CustomSync can be used in both front-end and node applications.

Bower

bower install -S backbone.customsync

NPM

npm install --save backbone.customsync

Usage

Backbone.CustomSync exposes an extended Model and Collection with Backbone.CustomSync.Model and Backbone.CustomSync.Collection.

var Todo = Backbone.CustomSync.Model.extend({

  // called by fetch
  readSync: function (options) {
    if (successful) {
      options.success(response);
    } else {
      options.error(response);
    }
  },

  // called by create and save (if the model is new)
  createSync: function (options) {
    if (successful) {
      options.success(response);
    } else {
      options.error(response);
    }
  },

  // called by save
  updateSync: function (options) {
    if (successful) {
      options.success(response);
    } else {
      options.error(response);
    }
  },

  // called by destroy
  deleteSync: function (options) {
    if (successful) {
      options.success(response);
    } else {
      options.error(response);
    }
  }

});

About

A Backbone extension that allows you to write custom methods for individual sync procedures.

Resources

Stars

Watchers

Forks

Packages

No packages published