@mobilabs/spine

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.

Changelog

2.0.3 (September 11, 2024)

• Fixed regex on $initialize, $listen, etc. that failed on minified library,
  • Release.