https://github.com/bigpipe/extendible

Extend constructors, just you are used to in Backbone.js
https://github.com/bigpipe/extendible

Last synced: 1 day ago
JSON representation

Extend constructors, just you are used to in Backbone.js

• Host: GitHub
• URL: https://github.com/bigpipe/extendible
• Owner: bigpipe
• Created: 2012-09-14T11:37:23.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2020-10-26T13:15:46.000Z (about 4 years ago)
• Last Synced: 2024-10-29T11:10:00.355Z (9 days ago)
• Language: JavaScript
• Size: 17.6 KB
• Stars: 2
• Watchers: 7
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# extendible

[![Version npm][version]](http://browsenpm.org/package/extendible)[![Build Status][build]](https://travis-ci.org/bigpipe/extendible)[![Dependencies][david]](https://david-dm.org/bigpipe/extendible)[![Coverage Status][cover]](https://coveralls.io/r/bigpipe/extendible?branch=master)

[from]: https://img.shields.io/badge/from-bigpipe.io-9d8dff.svg?style=flat-square

[version]: http://img.shields.io/npm/v/extendible.svg?style=flat-square

[build]: http://img.shields.io/travis/bigpipe/extendible/master.svg?style=flat-square

[david]: https://img.shields.io/david/bigpipe/extendible.svg?style=flat-square

[cover]: http://img.shields.io/coveralls/bigpipe/extendible/master.svg?style=flat-square

Extend your JavaScript constructor in the same way as would extend Backbone.js

Models using the `extend` method. Extending and inheritance has never been

easier and more developer friendly. While the original version was straight port

of the Backbone's source it has been re factored and rewritten many times to the

project it is today. It features:

- Backbone compatible `extend` API.

- Support for EcmaScript 5 getters and setters.

- Understands the difference between constructors that are created in `use

  strict` mode.

## Installation

The module is intended for server-side and browser usage. We use feature

detection to ensure compatibility with EcmaScript 3 based environments. The

module is distributed through `npm` and can be installed using:

```

npm install --save extendible

```

## Usage

In all example code we assume that you've already required the `extendible`

module and saved it as the `extend` variable as shown in the following example:

```js

var extend = require('extendible');

```

The extend method should be on the constructor as `.extend` method:

```js

function Word() {

  this.foo = 'bar';

}

//

// It should be added on the constructor, not as property on the prototype!

//

Word.extend = extend;

```

To create a new **Foo** class of your own you call the `Foo.extend` method with

2 arguments:

1. `Object` properties and methods that should be added to your extended class

   prototype. These will override existing properties, but it would not override

   the properties on the parent/root class that you extend on.

2. `Object` properties and methods that should added on the `constructor`

   directly. So instead of being introduced on the `.prototype` it's directly

   added to the returned Function.

As the properties of the prototype and constructor are inherited from the

parent/root constructor you can further extended using the same **extend**

method:

```js

var Hello = Word.extend({

  name: 'hello',

  say: function update() {

    console.log('the word is: '+ this.name);

  }

});

var World = Hello.extend({

  name: 'world'

});

var world = new World();

world.say(); // 'the word is: world'

```

### License

MIT