@mobilabs/spine
v2.0.3
Published
A tiny MVC framework inspired from Backbone.js
Downloads
35
Readme
Spine
A tiny MVC framework freely inspired by Backbone.js.
Spine API
| Static Methods | Description | |:--------------------------|:-------------------------------------------------| | noConflict | returns a reference to this Spine object | | whoami | returns the name and the version of the library | | fetch | execute an HTTP request (GET, POST, PUT, DELETE) | | urify | extends an Uri with the query parameters |
Spine.Model API
| Methods | Description | |:--------------------------|:-------------------------------------------------| | Spine.Model({}) | returns a child constructor | | Empty Methods | | | $initialize | makes the init when the object is created | | $listen | listens for model events | | $parse | parses the downloaded object or bypass | | Public Methods | | | $get | returns the value of the passed-in property | | $getAll | returns an object with keys/vals of the model | | $set | sets or updates model property(ies) | | $remove | removes one or a set of model property(ies) | | $has | checks if the model has the passed-in property | | $fetch | retrieves a model from the server | | $save | sends a model subset (changed prop) to the server| | $delete | deletes a model from the server | | $urify | extends an Uri with the query parameters | | Public Events Methods | | | $on | listens for an event | | $one | listens for an event once | | $off | stops Listening the passed-in event | | $fire | fires an event | | $trigger | fires an event (alias) |
| Events | Description | |:--------------------------|:-------------------------------------------------| | change | fired by 'set' on model change | | change:prop | fired by 'set' on model property change | | remove | fired by 'remove' when all properties deleted | | remove:prop | fired by 'remove' when a property deleted | | load | fired by 'fetch' when model loaded from server | | save | fired by 'save' when model saved on server | | delete | fired by 'delete' when model deleted from server |
Spine.Collection API
| Methods | Description | |:--------------------------|:-------------------------------------------------| | Spine.Collection({}) | returns a child constructor | | Empty Methods | | | $initialize | makes the init when the object is created | | $listen | listens for model events | | $parse | parses the downloaded array of objects or bypass | | Public Methods | | | $get | returns a model from its cid or id | | $each | returns the models one by one | | $next | returns the next model from the given model | | $previous | returns the previous model from the given model | | $length | returns the number of models in the collection | | $empty | deletes a collection (not from server) | | $add | adds one or more objects to the collection | | $remove | removes model(s) from the collection | | $fetch | retrieves new models from the server and appends them to the collection | | $save | sends a collection subset (changed prop) to the server | | $delete | deletes a set of models from the server and collection | | $urify | extends an Uri with the query parameters | | Public Events Methods | | | $on | listens for an event | | $one | listens for an event once | | $off | stops Listening the passed-in event | | $fire | fires an event | | $trigger | fires an event (alias) |
| Events | Description | |:--------------------------|:-------------------------------------------------| | add | fired by the 'add' method for each added model | | addcomplete | fired by 'add' when all added | | load | fired by the 'fetch' method | | save | fired by 'save' when collection saved on server | | remove | fired by the 'remove' method for each model removed | | removecomplete | fired by the 'remove' when all removed | | delete | fired by 'delete' when model deleted from server |
Spine.View API
| Methods | Description | |:--------------------------|:-------------------------------------------------| | Spine.View({}) | returns a child constructor | | Empty Methods | | | $initialize | makes the init when the object is created | | $render | renders the view in the DOM | | Public Methods | | | none | | | Public Events Methods | | | $on | listens for an event | | $one | listens for an event once | | $off | stops Listening the passed-in event | | $fire | fires an event | | $trigger | fires an event (alias) |
Spine.Router
| Methods | Description | |:--------------------------|:-------------------------------------------------| | Spine.Router({}) | returns a child constructor | | Empty Methods | | | $initialize | makes the init when the object is created | | Public Methods | | | $navigate | updates the url or triggers a route | | $getLastRoute | returns the latest route stored in the history | | $stop | stops the router listening for hash changes |
Spine.History
| Static Methods | Description | |:--------------------------|:-------------------------------------------------| | start | starts recording the route history | | stop | stops recording the route history | | isHistoryRunning | returns the history state | | get | returns the route in the history stack | | push | pushes a route in the stack | | pop | removes the latest entered route and returns it |
Spine.Radio
| Static Methods | Description | |:--------------------------|:-------------------------------------------------| | on | listens for an event | | one | listens for an event once | | off | stops Listening the passed-in event | | fire | fires an event | | trigger | fires an event |
License
MIT.