handlar.js

Dropped this a while back, may pick it up, again, soon. A more complete version was made for a prior company, so this one never got the updates. Will recode.

Simple MVC without the V or the C.

• Simple JSON object event handling library.
• Inspired by the idea of a client-side unified object model.
• And on realizing backbone.js has way more complexity than I need.

Dependencies

• underscore.js
• .defineProperty-compatible browser
• ._proto_-compatible browser

Object Structure

• Model
  • Handle
    • $ : function
    • $on : function
    • $off : function
    • $delete : function
    • \<property>... : Handle

Events

• implemented

  • all
  • change
  • delete

• coming...

  • add
  • invalid
  • remove
  • sort

Examples

Object Instantiation

M = new Model();

handle = new M.Handle({
    a: 1,
    b: {
        x:'X',
        y:'Y'
    }
});

JSON Object

handle.a.$
-> 1
handle.b.$
-> {x:'X',y:'Y'}
handle.b.x.$
-> "X"

===

Event Handling

Event: change

handle.a.$on('change',function(val,old){console.log('change! '+old+' => '+val)})
handle.a = 3
-> change! 1 => 3

Event: delete

$delete() feels like it ought take an argument and delete its caller's property, rather than deleting the caller, itself. Will consider this for later.

handle.a.$on('delete',function(old){console.log('delete! '+old)})
handle.a.$delete()
-> delete! 3

// And now it looks like...
handle.$
-> {b:{x:'X',y:'Y'}}

Event removal

// Some setup
q = function(){console.log('All is transient')}
handle.b.x.$on('change',q)
handle.b.x = 'axe'
-> All is transient

// The removal
handle.b.x.$off('change',q)
handle.b.x = 'ecks'
->

Modify all

Modify some

Reference

Model

• These will eventually be more complex, perhaps storing url data akin to backbone.js' process, but for now, it acts closer to a namespace than anything else.

===

Handle

• This is the most important object "class". It creates a clone of the supplied object, and can be referenced in a very close to natural object handling manner.
• Do note, it is intended to work iwth JSON-parsable objects only.

Handle.$

value

• Returns a clone Handle structure, as a normal JSON object.

Handle.$on

function(eventName, func, args)

• Adds an event listener.

Handle.$off

function(eventName, func)

• Removes an event listener.

Handle.$delete

function()

• Removes the calling Handle of the $delete() function from its parent. Recursively deletes child nodes, in a depth-first property-enumerating manner.

Handle.\<property>...

• Child Handle objects. Leaf nodes of such objects have implemented .valueOf methods, and so can be used in numerical equations and string concatenations without having to finish the reference with a .$.
• Unfortunately, it wasn't possible to define properties on Number, String, and Boolean types, so literal values only really appear amidst such operations.