/* Evento version 0 - JavaScript libraries for working with the observer pattern Copyright (c) 2012, Peter Michaux All rights reserved. Licensed under the Simplified BSD License. https://github.com/petermichaux/evento/blob/master/LICENSE */var evento = {}; /** @property evento.EventTarget @description A constructor function for creating event target objects. var et = new evento.EventTarget(); The methods of an event target object are inspired by the DOM2 standard. */ evento.EventTarget = function() {}; (function() { function hasOwnProperty(o, p) { return Object.prototype.hasOwnProperty.call(o, p); } var create = (function() { function F() {} return function(o) { F.prototype = o; return new F(); }; }()); /** @property evento.EventTarget.prototype.addEventListener @parameter type {string} The name of the event. @parameter listener {object|function} The listener object or callback function. @description If the listener is an object then when a matching event type is dispatched on the event target, the listener object's handleEvent method will be called. If the listener is a function then when a matching event type is dispatched on the event target, the listener function is called with event target object set as the "this" object. One listener (or type/listener pair to be more precise) can be added only once. et.addEventListener('change', {handleEvent:function(){}}); et.addEventListener('change', function(){}); */ evento.EventTarget.prototype.addEventListener = function(type, listener) { hasOwnProperty(this, '_evento_listeners') || (this._evento_listeners = {}); hasOwnProperty(this._evento_listeners, type) || (this._evento_listeners[type] = []); var listeners = this._evento_listeners[type]; for (var i = 0, ilen = listeners.length; i < ilen; i++) { if (listeners[i] === listener) { // can only add a listener once return; } } listeners.push(listener); }; /** @property evento.EventTarget.prototype.removeEventListener @parameter type {string} The name of the event. @parameter listener {object|function} The listener object or callback function. @description Removes added listener matching the type/listener combination exactly. If this combination is not found there are no errors. var o = {handleEvent:function(){}}; et.removeEventListener('change', o); et.removeEventListener('change', fn); */ evento.EventTarget.prototype.removeEventListener = function(type, listener) { if (hasOwnProperty(this, '_evento_listeners') && hasOwnProperty(this._evento_listeners, type)) { var listeners = this._evento_listeners[type]; for (var i = 0, ilen = listeners.length; i < ilen; i++) { if (listeners[i] === listener) { listeners.splice(i, 1); // no need to continue since a particular listener // can only be added once return; } } } }; /** @property evento.EventTarget.prototype.addParentEventTarget @parameter parent {EventTarget} A parent to call when bubbling an event. @description When an event is dispatched on an event target, if that event target has parents then the event is also dispatched on the parents as long as bubbling has not been canceled on the event. One parent can be added only once. var o = new evento.EventTarget(); et.addParentEventTarget(o); */ evento.EventTarget.prototype.addParentEventTarget = function(parent) { if (typeof parent.dispatchEvent !== 'function') { throw new TypeError('evento.EventTarget.prototype.addParentEventTarget: Parents must have dispatchEvent method.'); } hasOwnProperty(this, '_evento_parents') || (this._evento_parents = []); var parents = this._evento_parents; for (var i = 0, ilen = parents.length; i < ilen; i++) { if (parents[i] === parent) { // can only add a particular parent once return; } } parents.push(parent); }; /** @property evento.EventTarget.prototype.removeParentEventTarget @parameter parent {EventTarget} The parent to remove. @description Removes parent added with addParentEventTarget. If the listener is not found there are no errors. var o = {handleEvent:function(){}}; et.removeParentEventTarget(o); */ evento.EventTarget.prototype.removeParentEventTarget = function(parent) { if (hasOwnProperty(this, '_evento_parents')) { var parents = this._evento_parents; for (var i = 0, ilen = parents.length; i < ilen; i++) { if (parents[i] === parent) { parents.splice(i, 1); // no need to continue as parent can be added only once return; } } } }; /** @property evento.EventTarget.prototype.dispatchEvent @parameter evt {object} The event object to dispatch to all listeners. @description The evt.type property is required. All listeners registered for this event type are called with evt passed as an argument to the listeners. If not set, the evt.target property will be set to be the event target. The evt.currentTarget will be set to be the event target. Call evt.stopPropagation() to stop bubbling to parents. et.dispatchEvent({type:'change'}); et.dispatchEvent({type:'change', extraData:'abc'}); */ evento.EventTarget.prototype.dispatchEvent = function(evt) { // Want to ensure we don't alter the evt object passed in as it // may be a bubbling event. So clone it and then setting currentTarget // won't break some event that is already being dispatched. evt = create(evt); ('target' in evt) || (evt.target = this); // don't change target on bubbling event evt.currentTarget = this; evt._propagationStopped = ('bubbles' in evt) ? !evt.bubbles : false; evt.stopPropagation = function() { evt._propagationStopped = true; }; if (hasOwnProperty(this, '_evento_listeners') && hasOwnProperty(this._evento_listeners, evt.type)) { // Copy the list of listeners in case one of the // listeners modifies the list while we are // iterating over the list. // // Without making a copy, one listener removing // an already-called listener would result in skipping // a not-yet-called listener. One listener removing // a not-yet-called listener would result in skipping that // not-yet-called listner. The worst case scenario // is a listener adding itself again which would // create an infinite loop. // var listeners = this._evento_listeners[evt.type].slice(0); for (var i = 0, ilen = listeners.length; i < ilen; i++) { var listener = listeners[i]; if (typeof listener === 'function') { listener.call(this, evt); } else { listener.handleEvent(evt); } } } if (hasOwnProperty(this, '_evento_parents') && !evt._propagationStopped) { var parents = this._evento_parents.slice(0); for (var i = 0, ilen = parents.length; i < ilen; i++) { parents[i].dispatchEvent(evt); } } }; // Insure the prototype object is initialized properly evento.EventTarget.call(evento.EventTarget.prototype); /** @property evento.EventTarget.mixin @parameter obj {object} The object to be made into an event target. @description Mixes in the event target methods into any object. // Example 1 app.Person = function(name) { evento.EventTarget.call(this); this.setName(name); }; evento.EventTarget.mixin(app.Person.prototype); app.Person.prototype.setName = function(newName) { var oldName = this.name; this.name = newName; this.dispatchEvent({ type: "change", oldName: oldName, newName: newName }); }; var person = new app.Person('David'); person.addEventListener('change', function(evt) { alert('"' + evt.oldName + '" is now called "' + evt.newName + '".'); }); person.setName('Dave'); // Example 2 var o = {}; evento.EventTarget.mixin(o); o.addEventListener('change', function(){alert('change');}); o.dispatchEvent({type:'change'}); */ evento.EventTarget.mixin = function(obj) { var pt = evento.EventTarget.prototype; for (var p in pt) { if (hasOwnProperty(pt, p) && // Don't want to copy evento.EventTarget.prototype._evento_listeners object // or the evento.EventTarget.prototype._evento_parents object. Want the obj object // to have its own listeners and parents and not share listeners and parents // with evento.EventTarget.prototype. (typeof pt[p] === 'function')) { obj[p] = pt[p]; } } evento.EventTarget.call(obj); }; }()); /** @property evento.on @parameter element {EventTarget} The object you'd like to observe. @parameter type {string} The name of the event. @parameter listener {object|function} The listener object or callback function. @parameter auxArg {string|object} Optional. See description. @description If the listener is an object then when a matching event type is dispatched on the event target, the listener object's handleEvent method will be called. By supplying a string value for auxArg you can specify the name of the method to be called. You can also supply a function object for auxArg for early binding. If the listener is a function then when a matching event type is dispatched on the event target, the listener function is called with event target object set as the "this" object. Using the auxArg you can specifiy a different object to be the "this" object. One listener (or type/listener/auxArg pair to be more precise) can be added only once. var o = { handleEvent: function(){}, handleClick: function(){} }; // late binding. handleEvent is found when each event is dispatched evento.on(document.body, 'click', o); // late binding. handleClick is found when each event is dispatched evento.on(document.body, 'click', o, 'handleClick'); // early binding. The supplied function is bound now evento.on(document.body, 'click', o, o.handleClick); evento.on(document.body, 'click', o, function(){}); // supplied function will be called with document.body as this object evento.on(document.body, 'click', function(){}); // The following form is supported but is not neccessary given the options // above and it is recommended you avoid it. evento.on(document.body, 'click', this.handleClick, this); */ /** @property evento.off @parameter element {EventTarget} The object you'd like to stop observing. @parameter type {string} The name of the event. @parameter listener {object|function} The listener object or callback function. @parameter auxArg {string|object} Optional. @description Removes added listener matching the element/type/listener/auxArg combination exactly. If this combination is not found there are no errors. var o = {handleEvent:function(){}, handleClick:function(){}}; evento.off(document.body, 'click', o); evento.off(document.body, 'click', o, 'handleClick'); evento.off(document.body, 'click', o, fn); evento.off(document.body, 'click', fn); evento.off(document.body, 'click', this.handleClick, this); */ /** @property evento.purge @parameter listener {EventListener} The listener object that should stop listening. @description Removes all registrations of the listener added through evento.on. This purging should be done before your application code looses its last reference to listener. (This can also be done with more work using evento.off for each registeration.) If the listeners are not removed or purged, the listener will continue to observe the EventTarget and cannot be garbage collected. In an MVC application this can lead to "zombie views" if the model data cannot be garbage collected. Event listeners need to be removed from event targets in browsers with circular reference memory leak problems (i.e. old versions of Internet Explorer.) The primary motivation for this purge function is to easy cleanup in MVC View destroy methods. For example, var APP_BoxView = function(model, controller) { this.model = model || new APP_BoxModel(); this.controller = controller || new APP_BoxController(); this.rootEl = document.createElement('div'); // subscribe to DOM node(s) and model object(s) or anything else // implementing the EventTarget interface using listener objects // and specifying method name using the same subscription interface. // evento.on(this.rootEl, 'click', this, 'handleClick'); evento.on(this.model, 'change', this, 'handleModelChange'); }; APP_BoxView.prototype.handleClick = function() { // might subscribe/unsubscribe to more DOM nodes or models here }; APP_BoxView.prototype.handleModelChange = function() { // might subscribe/unsubscribe to more DOM nodes or models here }; APP_BoxView.prototype.destroy = function() { // Programmer doesn't need to remember anything. Purge all subscriptions // to DOM nodes, model objects, or anything else implementing // the EventTarget interface in one fell swoop. // evento.purge(this); }; */ (function() { function createBundle(element, type, listener, /*optional*/ auxArg) { var bundle = { element: element, type: type, listener: listener }; if (arguments.length > 3) { bundle.auxArg = auxArg; } if (typeof listener === 'function') { var thisObj = arguments.length > 3 ? auxArg : element; bundle.wrappedHandler = function(evt) { listener.call(thisObj, evt); }; } else if (typeof auxArg === 'function') { bundle.wrappedHandler = function(evt) { auxArg.call(listener, evt); }; } else { var methodName = arguments.length > 3 ? auxArg : 'handleEvent'; bundle.wrappedHandler = function(evt) { listener[methodName](evt); }; } return bundle; } function bundlesAreEqual(a, b) { return (a.element === b.element) && (a.type === b.type) && (a.listener === b.listener) && ((!a.hasOwnProperty('auxArg') && !b.hasOwnProperty('auxArg')) || (a.hasOwnProperty('auxArg') && b.hasOwnProperty('auxArg') && (a.auxArg === b.auxArg))); } function indexOfBundle(bundles, bundle) { for (var i = 0, ilen = bundles.length; i < ilen; i++) { if (bundlesAreEqual(bundles[i], bundle)) { return i; } } return -1; } evento.on = function(element, type, listener, /*optional*/ auxArg) { // Want to call createBundle with the same number of arguments // that were passed to this function. Using apply preserves // the number of arguments. var bundle = createBundle.apply(null, arguments); if (listener._evento_bundles) { if (indexOfBundle(listener._evento_bundles, bundle) >= 0) { // do not add the same listener twice return; } } else { listener._evento_bundles = []; } if (typeof bundle.element.addEventListener === 'function') { bundle.element.addEventListener(bundle.type, bundle.wrappedHandler, false); } else if ((typeof bundle.element.attachEvent === 'object') && (bundle.element.attachEvent !== null)) { bundle.element.attachEvent('on'+bundle.type, bundle.wrappedHandler); } else { throw new Error('evento.on: Supported EventTarget interface not found.'); } listener._evento_bundles.push(bundle); }; var remove = evento.off = function(element, type, listener, /*optional*/ auxArg) { if (listener._evento_bundles) { var i = indexOfBundle(listener._evento_bundles, createBundle.apply(null, arguments)); if (i >= 0) { var bundle = listener._evento_bundles[i]; if (typeof bundle.element.removeEventListener === 'function') { bundle.element.removeEventListener(bundle.type, bundle.wrappedHandler, false); } else if ((typeof bundle.element.detachEvent === 'object') && (bundle.element.detachEvent !== null)) { bundle.element.detachEvent('on'+bundle.type, bundle.wrappedHandler); } else { throw new Error('evento.off: Supported EventTarget interface not found.'); } listener._evento_bundles.splice(i, 1); } } }; evento.purge = function(listener) { if (listener._evento_bundles) { var bundles = listener._evento_bundles.slice(0); for (var i = 0, ilen = bundles.length; i < ilen; i++) { var bundle = bundles[i]; if (bundle.hasOwnProperty('auxArg')) { remove(bundle.element, bundle.type, bundle.listener, bundle.auxArg); } else { remove(bundle.element, bundle.type, bundle.listener); } } } }; }()); /* Hijos version 2 Copyright (c) 2012, Peter Michaux All rights reserved. Licensed under the Simplified BSD License. https://github.com/petermichaux/hijos/blob/master/LICENSE */ var hijos = {}; /** @property hijos.Leaf @description A constructor function for creating Leaf objects to be used as part of the composite design pattern. Leaf objects have three read-only properties describing the Leaf object's relationships to other Leaf and Node objects participating in the composite pattern. 1. parentNode 2. previousSibling 3. nextSibling These properties will be null when the Leaf is not a child of a Node object. To attach a Leaf to a Node, use the Node's child manipulation methods: appendChild, insertBefore, replaceChild. To remove a Leaf from a Node use the Node's removeChild method. var leaf = new hijos.Leaf(); */ hijos.Leaf = function() { this.parentNode = null; this.previousSibling = null; this.nextSibling = null; }; /** @property hijos.Leaf.prototype.destroy @description Call before your application code looses its last reference to the object. Generally this will be called for you by the destroy method of the containing Node object unless this Leaf object is not contained by a Node. */ hijos.Leaf.prototype.destroy = function() { // Loosing references to relations may help garbage collection. this.parentNode = null; this.previousSibling = null; this.nextSibling = null; }; // insure prototype object is initialized properly hijos.Leaf.call(hijos.Leaf.prototype); /** @property hijos.Leaf.mixin @parameter obj {object} The object to become a Leaf. @description Mixes in the Leaf methods into any object. Be sure to call the hijos.Leaf constructor to initialize the Leaf's properties. app.MyView = function() { hijos.Leaf.call(this); }; hijos.Leaf.mixin(app.MyView.prototype); */ hijos.Leaf.mixin = function(obj) { obj.destroy = hijos.Leaf.prototype.destroy; hijos.Leaf.call(obj); }; /** @property hijos.Node @description A constructor function for creating Node objects with ordered children to be used as part of the composite design pattern. Node objects have six read-only properties describing the Node's relationships to other Leaf and Node objects participating in the composite pattern. 1. childNodes 2. firstChild 3. lastChild 4. parentNode 5. previousSibling 6. nextSibling The firstChild and lastChild properties will be null when the Node has no children. Do not mutate the elements of the childNodes array directly. Instead use the appendChild, insertBefore, replaceChild, and removeChild methods to manage the children. The parentNode, previousSibling, and nextSibling properties will be null when the Node object is not a child of another Node object. var node = new hijos.Node(); */ hijos.Node = function() { hijos.Leaf.call(this); this.childNodes = []; this.firstChild = null; this.lastChild = null; }; hijos.Leaf.mixin(hijos.Node.prototype); /** @property hijos.Node.prototype.destroy @description Call before your application code looses its last reference to the object. Generally this will be called for you by the destroy method of the containing Node object unless this object is not contained by another Node. */ hijos.Node.prototype.destroy = function() { // copy in case one of the destroy methods modifies this.childNodes var children = this.childNodes.slice(0); for (var i = 0, ilen = children.length; i < ilen; i++) { children[i].destroy(); } hijos.Leaf.prototype.destroy.call(this); // Loosing references to relations may help garbage collection. this.childNodes = null; this.firstChild = null; this.lastChild = null; }; /** @property hijos.Node.prototype.hasChildNodes @description Returns true if this Node has children. Otherwise returns false. */ hijos.Node.prototype.hasChildNodes = function() { return this.childNodes.length > 0; }; /** @property hijos.Node.prototype.insertBefore @parameter newChild {object} The Leaf or Node object to insert. @parameter oldChild {object|null} The child object to insert before. @description Inserts newChild before oldChild. If oldChild is null then this is equivalent to appending newChild. If newChild is a child of another Node then newChild is removed from that other Node before appending to this Node. var parent = new hijos.Node(); var child0 = new hijos.Leaf(); parent.insertBefore(child0, null); var child1 = new hijos.Node(); parent.insertBefore(child1, child0); */ hijos.Node.prototype.insertBefore = function(newChild, oldChild) { if (arguments.length < 2) { throw new Error('hijos.Node.prototype.insertBefore: not enough arguments.'); } // Allow caller to be sloppy and send undefined instead of null. if (oldChild === undefined) { oldChild = null; } // Is newChild is already in correct position? if ((newChild === oldChild) || // inserting a node before itself (oldChild && (oldChild.previousSibling === newChild)) || // inserting newChild where it already is ((oldChild === null) && this.lastChild === newChild)) { // inserting child at end when it is already at the end return; } // do not allow the creation of a circular tree structure var node = this; while (node) { if (node === newChild) { throw new Error('hijos.Node.prototype.insertBefore: Node cannot be inserted at the specified point in the hierarchy.'); } node = node.parentNode; } // continue with insertion var children = this.childNodes; // find index for newChild var indexForNewChild; if (oldChild === null) { // want to append to end of children indexForNewChild = children.length; } else { for (var i = 0, ilen = children.length; i < ilen; i++) { if (children[i] === oldChild) { indexForNewChild = i; break; } } if (typeof indexForNewChild !== 'number') { throw new Error('hijos.Node.prototype.insertBefore: Node was not found.'); } } // remove from previous composite var parent = newChild.parentNode; if (parent) { parent.removeChild(newChild); } // add to this composite children.splice(indexForNewChild, 0, newChild); this.firstChild = children[0]; this.lastChild = children[children.length - 1]; newChild.parentNode = this; var previousSibling = newChild.previousSibling = (children[indexForNewChild - 1] || null); if (previousSibling) { previousSibling.nextSibling = newChild; } var nextSibling = newChild.nextSibling = (children[indexForNewChild + 1] || null); if (nextSibling) { nextSibling.previousSibling = newChild; } }; /** @property hijos.Node.prototype.appendChild @parameter newChild {object} The Leaf or Node object to append. @description Adds newChild as the last child of this Node. If newChild is a child of another Node then newChild is removed from that other Node before appending to this Node. var parent = new hijos.Node(); var child = new hijos.Leaf(); parent.appendChild(child); var child = new hijos.Node(); parent.appendChild(child); */ hijos.Node.prototype.appendChild = function(newChild) { if (arguments.length < 1) { throw new Error('hijos.Node.prototype.appendChild: not enough arguments.'); } this.insertBefore(newChild, null); }; /** @property hijos.Node.prototype.replaceChild @parameter newChild {object} The Leaf or Node object to insert. @parameter oldChild {object} The child object to remove/replace. @description Replaces oldChild with newChild. If newChild is a child of another Node then newChild is removed from that other Node before appending to this Node. var parent = new hijos.Node(); var child0 = new hijos.Leaf(); parent.appendChild(child0); var child1 = new hijos.Node(); parent.replaceChild(child1, child0); */ hijos.Node.prototype.replaceChild = function(newChild, oldChild) { if (arguments.length < 2) { throw new Error('hijos.Node.prototype.replaceChild: not enough arguments.'); } if (!oldChild) { throw new Error('hijos.Node.prototype.replaceChild: oldChild must not be falsy.'); } // child is already in correct position and // do not want removeChild to be called below if (newChild === oldChild) { return; } this.insertBefore(newChild, oldChild); this.removeChild(oldChild); }; /** @property hijos.Node.prototype.removeChild @parameter oldChild {object} The child object to remove. @description Removes oldChild. var parent = new hijos.Node(); var child = new hijos.Leaf(); parent.appendChild(child); parent.removeChild(child); */ hijos.Node.prototype.removeChild = function(oldChild) { if (arguments.length < 1) { throw new Error('hijos.Node.prototype.removeChild: not enough arguments.'); } var children = this.childNodes; for (var i = 0, ilen = children.length; i < ilen; i++) { if (children[i] === oldChild) { var previousSibling = children[i - 1]; if (previousSibling) { previousSibling.nextSibling = oldChild.nextSibling; } var nextSibling = children[i + 1]; if (nextSibling) { nextSibling.previousSibling = oldChild.previousSibling; } oldChild.parentNode = null; oldChild.previousSibling = null; oldChild.nextSibling = null; children.splice(i, 1); this.firstChild = children[0] || null; this.lastChild = children[children.length - 1] || null; return; // stop looking } } throw new Error('hijos.Node.prototype.removeChild: node not found.'); }; // insure prototype object is initialized correctly hijos.Node.call(hijos.Node.prototype); /** @property hijos.Node.mixin @parameter obj {object} The object to become a Node. @description Mixes in the Node methods into any object. // Example 1 app.MyView = function() { hijos.Node.call(this); }; hijos.Node.mixin(app.MyView.prototype); // Example 2 var obj = {}; hijos.Node.mixin(obj); */ hijos.Node.mixin = function(obj) { for (var p in hijos.Node.prototype) { if (Object.prototype.hasOwnProperty.call(hijos.Node.prototype, p) && (typeof hijos.Node.prototype[p] === 'function')) { obj[p] = hijos.Node.prototype[p]; } } hijos.Node.call(obj); }; /* Arbutus version 2 Copyright (c) 2012, Peter Michaux All rights reserved. Licensed under the Simplified BSD License. https://github.com/petermichaux/arbutus/blob/master/LICENSE */var arbutus = {}; (function() { var trimLeft = /^\s+/, trimRight = /\s+$/; function trim(str) { return str.replace(trimLeft, '').replace(trimRight, ''); } function getFirstChild(element) { return element.firstChild; } function getFirstGrandChild(element) { return element.firstChild.firstChild; } function getSecondGrandChild(element) { return element.firstChild.firstChild.nextSibling; } function getFirstGreatGrandChild(element) { return element.firstChild.firstChild.firstChild; } function getFirstGreatGreatGrandChild(element) { return element.firstChild.firstChild.firstChild.firstChild; } function Parser(before, after, getFirstResult) { if (before) { this.before = before; } if (after) { this.after = after; } if (getFirstResult) { this.getFirstResult = getFirstResult; } }; Parser.prototype = { before: '', after: '', parse: function(html, doc) { var parser = doc.createElement('div'); var fragment = doc.createDocumentFragment(); parser.innerHTML = this.before + html + this.after; var node = this.getFirstResult(parser); var nextNode; while (node) { nextNode = node.nextSibling; fragment.appendChild(node); node = nextNode; } return fragment; }, getFirstResult: getFirstChild }; var parsers = { 'td': new Parser('
alpha beta
'); document.body.appendChild(fragment); Note that a call to this function is relatively expensive and you probably don't want to have a loop of thousands with calls to this function. */ arbutus.parseHTML = function(html, doc) { // IE will trim when setting innerHTML so unify for all browsers html = trim(html); var matches = html.match(tagRegExp), parser = (matches && parsers[matches[1].toLowerCase()]) || Parser.prototype; return parser.parse(html, doc || document); }; }()); /* Grail version 3 Copyright (c) 2012, Peter Michaux All rights reserved. Licensed under the Simplified BSD License. https://github.com/petermichaux/grail/blob/master/LICENSE */ var grail = {}; (function() { var trimLeft = /^\s+/; var trimRight = /\s+$/; // group 1 must be the id var idRegExp = /^#(\S+)$/; // group 1 must be the tagName and group 2 must be the className var tagClassRegExp = /^([\w-]+)?(?:\.([\w-]+))?$/; function trim(str) { return str.replace(trimLeft, '').replace(trimRight, ''); } function isHostMethod(obj, prop) { return (typeof obj[prop] === 'function') || ((typeof obj[prop] === 'object') && (obj[prop] !== null)); // Internet Explorer } function findById(id, root) { return (root.id === id) ? root : (isHostMethod(root, 'getElementById')) ? root.getElementById(id) : (isHostMethod(root, 'querySelector')) ? root.querySelector('#' + id) : firstInDOM(root, function(node) {return node.id === id;}); } function getTagNameClassNameMatcher(tagName, className) { tagName = tagName ? tagName.toUpperCase() : '*'; if (className) { var regExp = new RegExp('(?:^|\\s+)' + className + '(?:\\s+|$)'); } return function(element) { return (((tagName === '*') || (element.tagName && (element.tagName.toUpperCase() === tagName))) && ((!className) || regExp.test(element.className))); } } function filterDOM(node, func) { var results = []; function walk(node) { if (func(node)) { results.push(node); } node = node.firstChild; while (node) { walk(node); node = node.nextSibling; } } walk(node); return results; } function firstInDOM(node, func) { function walk(node) { if (func(node)) { return node; } node = node.firstChild; while (node) { var result = walk(node); if (result) { return result; } node = node.nextSibling; } } return walk(node); } /** @property grail.findAll @parameter selector {string} The CSS selector for the search. @parameter root {Document|Element} Optional element to use as the search start point. @description Search for all elements matching the CSS selector. Returns an array of the elements. Acceptable simple selectors are of the following forms only. div #alpha .beta div.gamma In the case of a #myId selector, the returned array will always have zero or one elements. It is more likely that you want to call grail.find when using an id selector. If the root element is supplied it is used as the starting point for the search. The root element will be in the results if it matches the selector. If the root element is not supplied then the current document is used as the search starting point. grail.findAll('#alpha'); grail.findAll('div.gamma', document.body); */ grail.findAll = function(selector, root) { selector = trim(selector); root = root || document; var matches; if (matches = selector.match(idRegExp)) { var el = findById(matches[1], root); return el ? [el] : []; } else if (matches = selector.match(tagClassRegExp)) { var tagNameClassNameMatcher = getTagNameClassNameMatcher(matches[1], matches[2]); if (isHostMethod(root, 'querySelectorAll')) { var elements; var results = []; if (tagNameClassNameMatcher(root)) { results.push(root); } elements = root.querySelectorAll(selector); for (var i = 0, ilen = elements.length; i < ilen; i++) { results.push(elements[i]); } return results; } else { return filterDOM(root, tagNameClassNameMatcher); } } else { throw new Error('grail.findAll: Unsupported selector "'+selector+'".'); } }; /** @property grail.find @parameter selector {string} The CSS selector for the search. @parameter root {Document|Element} Optional element to use as the search start point. @description Search for the first element matching the CSS selector. If the element is found then it is returned. If no matching element is found then null or undefined is returned. The rest of the details are the same as for grail.findAll. */ grail.find = function(selector, root) { selector = trim(selector); root = root || document; var matches; if (matches = selector.match(idRegExp)) { return findById(matches[1], root); } else if (matches = selector.match(tagClassRegExp)) { var tagNameClassNameMatcher = getTagNameClassNameMatcher(matches[1], matches[2]); if (isHostMethod(root, 'querySelector')) { return tagNameClassNameMatcher(root) ? root : root.querySelector(selector); } else { return firstInDOM(root, tagNameClassNameMatcher); } } else { throw new Error('grail.find: Unsupported selector "'+selector+'".'); } }; }()); /* Hormigas version 3 Copyright (c) 2012, Peter Michaux All rights reserved. Licensed under the Simplified BSD License. https://github.com/petermichaux/hormigas/blob/master/LICENSE */ var hormigas = {}; (function() { var nextId = 0; function getId() { return nextId++; } function initSet(set) { set._hormigas_ObjectSet_elements = {}; set.length = 0; } /** @property hormigas.ObjectSet @description A constructor function for creating set objects. ObjectSets are designed to hold JavaScript objects. They cache a marker on the objects. Do not attempt to add primitives or host objects in a ObjectSet. This is a compromise to make ObjectSet objects efficient for use in the model layer of your application. When using the set iterators (e.g. forEach, map) do not depend on the order of iteration of the set's elements. ObjectSets are unordered. var set = new hormigas.ObjectSet(); // an empty set ObjectSets have a length property that is the number of elements in the set. var alpha = {}; var beta = {}; var set = new hormigas.ObjectSet(alpha, beta, alpha); set.length; // 2 The methods of an event target object are inspired by the incomplete Harmony Set proposal and the Array.prototype iterators. */ hormigas.ObjectSet = function() { initSet(this); for (var i = 0, ilen = arguments.length; i < ilen; i++) { this.add(arguments[i]); } }; /** @property hormigas.ObjectSet.prototype.isEmpty @description Returns true if set is empty. Otherwise returns false. var alpha = {}; var set = new hormigas.ObjectSet(alpha); set.isEmpty(); // false set['delete'](alpha); set.isEmpty(); // true */ hormigas.ObjectSet.prototype.isEmpty = function() { return this.length < 1; }; /** @property hormigas.ObjectSet.prototype.has @parameter element @description Returns true if element is in the set. Otherwise returns false. var alpha = {}; var beta = {}; var set = new hormigas.ObjectSet(alpha); set.has(alpha); // true set.has(beta); // false */ hormigas.ObjectSet.prototype.has = function(element) { return Object.prototype.hasOwnProperty.call(element, '_hormigas_ObjectSet_id') && Object.prototype.hasOwnProperty.call(this._hormigas_ObjectSet_elements, element._hormigas_ObjectSet_id); }; /** @property hormigas.ObjectSet.prototype.add @parameter element @description If element is not already in the set then adds element to the set and returns true. Otherwise returns false. var alpha = {}; var set = new hormigas.ObjectSet(); set.add(alpha); // true set.has(alpha); // false */ hormigas.ObjectSet.prototype.add = function(element) { if (this.has(element)) { return false; } else { var id; if (!Object.prototype.hasOwnProperty.call(element, '_hormigas_ObjectSet_id')) { element._hormigas_ObjectSet_id = getId(); } this._hormigas_ObjectSet_elements[element._hormigas_ObjectSet_id] = element; this.length++; return true; } }; /** @property hormigas.ObjectSet.prototype.delete @parameter element @description If element is in the set then removes element from the set and returns true. Otherwise returns false. "delete" is a reserved word and older implementations did not allow bare reserved words in property name position so quote "delete". var alpha = {}; var set = new hormigas.ObjectSet(alpha); set['delete'](alpha); // true set['delete'](alpha); // false */ hormigas.ObjectSet.prototype['delete'] = function(element) { if (this.has(element)) { delete this._hormigas_ObjectSet_elements[element._hormigas_ObjectSet_id]; this.length--; return true; } else { return false; } }; /** @property hormigas.ObjectSet.prototype.empty @description If the set has elements then removes all the elements and returns true. Otherwise returns false. var alpha = {}; var set = new hormigas.ObjectSet(alpha); set.empty(); // true set.empty(); // false */ hormigas.ObjectSet.prototype.empty = function() { if (this.length > 0) { initSet(this); return true; } else { return false; } }; /** @property hormigas.ObjectSet.prototype.toArray @description Returns the elements of the set in a new array. */ hormigas.ObjectSet.prototype.toArray = function() { var elements = []; for (var p in this._hormigas_ObjectSet_elements) { if (Object.prototype.hasOwnProperty.call(this._hormigas_ObjectSet_elements, p)) { elements.push(this._hormigas_ObjectSet_elements[p]); } } return elements; }; /** @property hormigas.ObjectSet.prototype.forEach @parameter callbackfn {function} The function to call for each element in the set. @parameter thisArg {object} The optional object to use as the this object in calls to callbackfn. @description Calls callbackfn for each element of the set. var alpha = {value: 0}; var beta = {value: 1}; var gamma = {value: 2}; var set = new hormigas.ObjectSet(alpha, beta, gamma); set.forEach(function(element, set) { console.log(element.value); }); */ hormigas.ObjectSet.prototype.forEach = function(callbackfn /*, thisArg */) { var thisArg = arguments[1]; for (var p in this._hormigas_ObjectSet_elements) { if (Object.prototype.hasOwnProperty.call(this._hormigas_ObjectSet_elements, p)) { callbackfn.call(thisArg, this._hormigas_ObjectSet_elements[p], this); } } }; /** @property hormigas.ObjectSet.prototype.every @parameter callbackfn {function} The function to call for each element in the set. @parameter thisArg {object} The optional object to use as the this object in calls to callbackfn. @description Calls callbackfn for each element of the set. If callbackfn returns a truthy value for all elements then every returns true. Otherwise returns false. var one = {value: 1}; var two = {value: 2}; var three = {value: 3}; var set = new hormigas.ObjectSet(one, two, three); set.every(function(element, set) { return element.value < 2; }); // false */ hormigas.ObjectSet.prototype.every = function(callbackfn /*, thisArg */) { var thisArg = arguments[1]; for (var p in this._hormigas_ObjectSet_elements) { if (Object.prototype.hasOwnProperty.call(this._hormigas_ObjectSet_elements, p) && !callbackfn.call(thisArg, this._hormigas_ObjectSet_elements[p], this)) { return false; } } return true; }; /** @property hormigas.ObjectSet.prototype.some @parameter callbackfn {function} The function to call for each element in the set. @parameter thisArg {object} The optional object to use as the this object in calls to callbackfn. @description Calls callbackfn for each element of the set. If callbackfn returns a truthy value for at least one element then some returns true. Otherwise returns false. var one = {value: 1}; var two = {value: 2}; var three = {value: 3}; var set = new hormigas.ObjectSet(one, two, three); set.some(function(element, set) { return element.value < 2; }); // true */ hormigas.ObjectSet.prototype.some = function(callbackfn /*, thisArg */) { var thisArg = arguments[1]; for (var p in this._hormigas_ObjectSet_elements) { if (Object.prototype.hasOwnProperty.call(this._hormigas_ObjectSet_elements, p) && callbackfn.call(thisArg, this._hormigas_ObjectSet_elements[p], this)) { return true; } } return false; }; /** @property hormigas.ObjectSet.prototype.reduce @parameter callbackfn {function} The function to call for each element in the set. @parameter initialValue {object} The optional starting value for accumulation. @description Calls callbackfn for each element of the set. For the first call to callbackfn, if initialValue is supplied then initalValue is the first argument passed to callbackfn and the second argument is the first element in the set to be iterated. Otherwise the first argument is the first element to be iterated in the set and the second argument is the next element to be iterated in the set. For subsequent calls to callbackfn, the first argument is the value returned by the last call to callbackfn. The second argument is the next value to be iterated in the set. var one = {value: 1}; var two = {value: 2}; var three = {value: 3}; var set = new hormigas.ObjectSet(one, two, three); set.reduce(function(accumulator, element) { return {value: accumulator.value + element.value}; }); // {value:6} set.reduce(function(accumulator, element) { return accumulator + element.value; }, 4); // 10 */ hormigas.ObjectSet.prototype.reduce = function(callbackfn /*, initialValue */) { var elements = this.toArray(); var i = 0; var ilen = elements.length; var accumulator; if (arguments.length > 1) { accumulator = arguments[1]; } else if (ilen < 1) { throw new TypeError('reduce of empty set with no initial value'); } else { i = 1; accumulator = elements[0]; } while (i < ilen) { accumulator = callbackfn.call(undefined, accumulator, elements[i], this); i++; } return accumulator; }; /** @property hormigas.ObjectSet.prototype.map @parameter callbackfn {function} The function to call for each element in the set. @parameter thisArg {object} The optional object to use as the this object in calls to callbackfn. @description Calls callbackfn for each element of the set. The values returned by callbackfn are added to a new array. This new array is the value returned by map. var alpha = {length: 5}; var beta = {length: 4}; var gamma = {length: 5}; var set = new hormigas.ObjectSet(alpha, beta, gamma); set.map(function(element) { return element.length; }); // [5,5,4] or [5,4,5] or [4,5,5] */ hormigas.ObjectSet.prototype.map = function(callbackfn /*, thisArg */) { var thisArg = arguments[1]; var result = []; for (var p in this._hormigas_ObjectSet_elements) { if (Object.prototype.hasOwnProperty.call(this._hormigas_ObjectSet_elements, p)) { result.push(callbackfn.call(thisArg, this._hormigas_ObjectSet_elements[p], this)); } } return result; }; /** @property hormigas.ObjectSet.prototype.filter @parameter callbackfn {function} The function to call for each element in the set. @parameter thisArg {object} The optional object to use as the this object in calls to callbackfn. @description Calls callbackfn for each element of the set. If callbackfn returns true for an element then that element is added to a new array. This new array is the value returned by filter. var alpha = {length: 5}; var beta = {length: 4}; var gamma = {length: 5}; var set = new hormigas.ObjectSet(alpha, beta, gamma); set.filter(function(element) { return element.length > 4; }); // [alpha, gamma] or [gamma, alpha] */ hormigas.ObjectSet.prototype.filter = function(callbackfn /*, thisArg */) { var thisArg = arguments[1]; var result = []; for (var p in this._hormigas_ObjectSet_elements) { if (Object.prototype.hasOwnProperty.call(this._hormigas_ObjectSet_elements, p)) { var element = this._hormigas_ObjectSet_elements[p]; if (callbackfn.call(thisArg, element, this)) { result.push(element); } } } return result; }; }()); // insure prototype object is initialized properly hormigas.ObjectSet.call(hormigas.ObjectSet.prototype); /** @property hormigas.ObjectSet.mixin @parameter obj {object} The object to become a ObjectSet. @description Mixes in the ObjectSet methods into any object. // Example 1 app.MyModel = function() { hormigas.ObjectSet.call(this); }; hormigas.ObjectSet.mixin(app.MyModel.prototype); // Example 2 var obj = {}; hormigas.ObjectSet.mixin(obj); */ hormigas.ObjectSet.mixin = function(obj) { for (var p in hormigas.ObjectSet.prototype) { if (Object.prototype.hasOwnProperty.call(hormigas.ObjectSet.prototype, p) && (typeof hormigas.ObjectSet.prototype[p] === 'function')) { obj[p] = hormigas.ObjectSet.prototype[p]; } } hormigas.ObjectSet.call(obj); }; /* Maria release candidate 5 - an MVC framework for JavaScript applications Copyright (c) 2012, Peter Michaux All rights reserved. Licensed under the Simplified BSD License. https://github.com/petermichaux/maria/blob/master/LICENSE */var maria = {}; // Not all browsers supported by Maria have Object.create maria.create = (function() { function F() {} return function(obj) { F.prototype = obj; return new F(); }; }()); maria.borrow = function(sink, source) { for (var p in source) { if (Object.prototype.hasOwnProperty.call(source, p)) { sink[p] = source[p]; } } }; // "this" must be a constructor function // mix the "subclass" function into your constructor function // maria.subclass = function(namespace, name, options) { options = options || {}; var properties = options.properties; var SuperConstructor = this; var Constructor = namespace[name] = Object.prototype.hasOwnProperty.call(options, 'constructor') ? options.constructor : function() { SuperConstructor.apply(this, arguments); }; var prototype = Constructor.prototype = maria.create(SuperConstructor.prototype); prototype.constructor = Constructor; if (properties) { maria.borrow(prototype, properties); } Constructor.subclass = function() { SuperConstructor.subclass.apply(this, arguments); }; }; maria.on = function() { evento.on.apply(this, arguments); }; maria.off = function() { evento.off.apply(this, arguments); }; maria.purge = function() { evento.purge.apply(this, arguments); }; /** @property maria.Model @description A constructor function to create new model objects. var model = new maria.Model(); The most interesting feature of model objects is that they are event targets and so can be observed by any event listeners. Other model objects, view objects, or any other interested objects can observe by being added as event listeners. For example, the following view object's "update" method will be called when a "change" event is dispatched on the model objects. var view = { update: function(evt) { alert('The model changed!'); } }; maria.on(model, 'change', view, 'update'); The model can dispatch a "change" event on itself when the model changes. model.setContent = function(content) { this._content = content; model.dispatchEvent({type: 'change'}); }; If desired, a model can push additional data to its observers by including that data on the event object. model.setContent = function(content) { var previousContent = this._content; this._content = content; model.dispatchEvent({ type: 'change', previousContent: previousContent, content: content }); }; An event listener can be removed from a model object. maria.off(model, 'change', view, 'update'); A particularly useful pattern is using maria.Model as the "superclass" of your application's model. The following example shows how this can be done at a low level for a to-do application. See maria.Model.subclass for a more compact way to accomplish the same. checkit.TodoModel = function() { maria.Model.apply(this, arguments); }; checkit.TodoModel.prototype = maria.create(maria.Model.prototype); checkit.TodoModel.prototype.constructor = checkit.TodoModel; checkit.TodoModel.prototype._content = ''; checkit.TodoModel.prototype._isDone = false; checkit.TodoModel.prototype.getContent = function() { return this._content; }; checkit.TodoModel.prototype.setContent = function(content) { content = checkit.trim('' + content); if (this._content !== content) { this._content = content; this.dispatchEvent({type: 'change'}); } }; checkit.TodoModel.prototype.isDone = function() { return this._isDone; }; checkit.TodoModel.prototype.setDone = function(isDone) { isDone = !!isDone; if (this._isDone !== isDone) { this._isDone = isDone; this.dispatchEvent({type: 'change'}); } }; checkit.TodoModel.prototype.toggleDone = function() { this.setDone(!this.isDone()); }; When a model's "destroy" method is called, a "destroy" event is dispatched and all event listeners who've been added for this event type will be notified. (See evento.EventTarget for advanced information about event bubbling using "addParentEventTarget" and "removeParentEventTarget".) */ maria.Model = function() { evento.EventTarget.call(this); }; maria.Model.prototype = maria.create(evento.EventTarget.prototype); maria.Model.prototype.constructor = maria.Model; maria.Model.prototype.destroy = function() { this.dispatchEvent({type: 'destroy'}); }; /** @property maria.SetModel @description A constructor function to create new set model objects. A set model object is a collection of elements. An element can only be included once in a set model object. The constructor takes multiple arguments and populates the set model with those elements. var alpha = new maria.Model(); alpha.name = 'Alpha'; var beta = new maria.Model(); beta.name = 'Beta'; var setModel = new maria.SetModel(alpha, beta); You can create an empty set model object. var setModel = new maria.SetModel(); What makes a set model object interesting in comparison to a set is that a set model object is a model object that dispatches "change" events when elements are added or deleted from the the set. var view = { update: function(evt) { alert(setModel.length + ' element(s) in the set.'); } }; maria.on(setModel, 'change', view, 'update'); You can add elements to the set. Adding an element that is already in the set has no effect. The add method returns true if the element is added to the set. setModel.add(alpha); // returns true, alpha was added setModel.add(alpha); // returns false, alpha not added again The add method accepts multiple objects and only dispatches a single "change" event if any of the arguments are added to the set model object. setModel.add(alpha, beta); // returns true, beta was added When elements are added to the set model object, all "change" event listeners are passed an event object with an addedTargets property which has an array containing all elements added to the set model object. You can check if an element is in the set. setModel.has(alpha); // returns true, alpha was added above You can get the number of elements in the set. setModel.length; // returns 2 An element can be deleted from the set. Removing it multiple times has no effect. The delete method returns true if the element is deleted from the set. setModel['delete'](alpha); // returns true, alpha was deleted setModel['delete'](alpha); // returns false, alpha wasn't in set The delete method accepts multiple objects. setModel['delete'](alpha, beta); // returns true, beta was removed When elements are deleted from the set model object, all "change" event listeners are passed an event object with a deletedTargets property which is an array containing all elements deleted from the set model object. Note that delete is a keyword in JavaScript and to keep old browsers happy you need to write setModel['delete']. You can write setModel.delete if old browsers are not supported by your application. You can empty a set in one call. The method returns true if any elements are removed from the set model object. setModel.empty(); // returns false, alpha and beta removed above. If the call to empty does delete elements from the set, all "change" event listeners are passed an event object with deletedTargets just as for the delete method. Another interesting feature of a set model object is that it observes its elements (for all elements that implement the event target interface) and when an element dispatches a "destroy" event then the element is automatically removed from the set model object. The set model object then dispatches a "change" event with a deletedTargets property just as for the delete method. A set model object has some other handy methods. setModel.add(alpha, beta); setModel.toArray(); // returns [alpha, beta] or [beta, alpha] setModel.forEach(function(element) { alert(element.name); }); setModel.every(function(element) { return element.name.length > 4; }); // returns false setModel.some(function(element) { return element.name.length > 4; }); // returns true setModel.reduce(function(accumulator, element) { return accumulator + element.name.length; }, 0); // returns 9 setModel.map(function(element) { return element.name.length; }); // returns [4, 5] or [5, 4] setModel.filter(function(element) { return element.name.length > 4; }); // returns [alpha] The order of the elements returned by toArray and the order of iteration of the other methods is undefined as a set is an unordered collection. Do not depend on any ordering that the current implementation uses. A particularly useful pattern is using maria.SetModel as the "superclass" of your application's collection model. The following example shows how this can be done at a low level for a to-do application. See maria.SetModel.subclass for a more compact way to accomplish the same. checkit.TodosModel = function() { maria.SetModel.apply(this, arguments); }; checkit.TodosModel.prototype = maria.create(maria.SetModel.prototype); checkit.TodosModel.prototype.constructor = checkit.TodosModel; checkit.TodosModel.prototype.getDone = function() { return this.filter(function(todo) { return todo.isDone(); }); }; checkit.TodosModel.prototype.getUndone = function() { return this.filter(function(todo) { return !todo.isDone(); }); }; checkit.TodosModel.prototype.isAllDone = function() { return this.length > 0 && (this.getDone().length === this.length); }; checkit.TodosModel.prototype.markAllDone = function() { this.forEach(function(todo) { todo.setDone(true); }); }; checkit.TodosModel.prototype.markAllUndone = function() { this.forEach(function(todo) { todo.setDone(false); }); }; checkit.TodosModel.prototype.deleteDone = function() { this['delete'].apply(this, this.getDone()); }; Another feature of set model objects is that events dispatched on elements of the set model object bubble up and are dispatched on the set model object. This makes it possible to observe only the set model object and still know when elements in the set are changing, for example. This can complement well the flyweight pattern used in a view. */ maria.SetModel = function() { hormigas.ObjectSet.apply(this, arguments); maria.Model.call(this); }; maria.SetModel.prototype = maria.create(maria.Model.prototype); maria.SetModel.prototype.constructor = maria.SetModel; hormigas.ObjectSet.mixin(maria.SetModel.prototype); // Wrap the set mutator methods to dispatch events. // takes multiple arguments so that only one event will be fired // maria.SetModel.prototype.add = function() { var added = []; for (var i = 0, ilen = arguments.length; i < ilen; i++) { var argument = arguments[i]; if (hormigas.ObjectSet.prototype.add.call(this, argument)) { added.push(argument); if ((typeof argument.addEventListener === 'function') && (typeof argument.removeEventListener === 'function')) { argument.addEventListener('destroy', this); } if ((typeof argument.addParentEventTarget === 'function') && // want to know can remove later (typeof argument.removeParentEventTarget === 'function')) { argument.addParentEventTarget(this); } } } var modified = added.length > 0; if (modified) { this.dispatchEvent({type: 'change', addedTargets: added, deletedTargets: []}); } return modified; }; // takes multiple arguments so that only one event will be fired // maria.SetModel.prototype['delete'] = function() { var deleted = []; for (var i = 0, ilen = arguments.length; i < ilen; i++) { var argument = arguments[i]; if (hormigas.ObjectSet.prototype['delete'].call(this, argument)) { deleted.push(argument); if (typeof argument.removeEventListener === 'function') { argument.removeEventListener('destroy', this); } if (typeof argument.removeParentEventTarget === 'function') { argument.removeParentEventTarget(this); } } } var modified = deleted.length > 0; if (modified) { this.dispatchEvent({type: 'change', addedTargets: [], deletedTargets: deleted}); } return modified; }; maria.SetModel.prototype.empty = function() { var deleted = this.toArray(); var result = hormigas.ObjectSet.prototype.empty.call(this); if (result) { for (var i = 0, ilen = deleted.length; i < ilen; i++) { var element = deleted[i]; if (typeof element.removeEventListener === 'function') { element.removeEventListener('destroy', this); } if (typeof element.removeParentEventTarget === 'function') { element.removeParentEventTarget(this); } } this.dispatchEvent({type: 'change', addedTargets: [], deletedTargets: deleted}); } return result; }; maria.SetModel.prototype.handleEvent = function(ev) { // If it is a destroy event being dispatched on the // destroyed element then we want to remove it from // this set. if ((ev.type === 'destroy') && (ev.currentTarget === ev.target)) { this['delete'](ev.target); } }; /** @property maria.View @parameter model {Object} Optional @parameter controller {Object} Optional @description A constructor function to create new view objects. var view = new maria.View(); This constructor function takes two optional arguments. var model = new maria.Model(); var controller = new maria.Controller(); var view = new maria.View(model, controller); The null or undefined value can be passed for either of these two parameters to skip setting it. A view is has a model. You can get the current model which might be undefined. view.getModel(); You can set the model. view.setModel(model); When a view object's model object is set, the view will, by convention, observe the model's "change" event. When a "change" event is dispatched on the model, the view's "update" method will be called. Your application will redefine or more likely override the update method. maria.View.prototype.update = function(evt) { alert('the model changed'); }; If necessary, you can change the events and methods that the view will observe when the model is set by redefining or overriding the getModelActions method. maria.View.prototype.getModelActions = function() { return { 'squashed': 'onSquashed', 'squished': 'onSquished' }; }; When the model is set, if the view had a previous model then the view will unsubscribe from the events it subscribed to on the prevous model when the previous model was set. A view has a controller. You can get the current controller. view.getController(); The view's controller is created lazily the first time the getController method is called. The view's getDefaultControllerConstructor method returns the constructor function to create the controller object and the getDefaultController actually calls that constructor. Your application may redefine or override either of these methods. A view has a destroy method which should be called before your application looses its last reference to the view. An view object is a composite view. This means the view can have child views added and removed. This functionality is provided by the Hijos library. Briefly, var childView1 = new maria.View(); var childView2 = new maria.View(); view.appendChild(childView1); view.replaceChild(childView2, childView1); view.insertBefore(childView1, childView2); view.removeChild(childView2); view.childNodes; view.firstChild; view.lastChild; childView1.nextSibling; childView1.previousSibling; childView1.parentNode; When a view's destroy method executes, it calls each child's destroy method. The maria.View constructor is relatively abstract. It is most likely that your application can use maria.ElementView; however, if you are creating a new type of view where maria.ElementView is not a good fit, for example a view that represents part of a bitmap drawing on a canvas element, then you may want to use maria.View as the "superclass" of your new view constructor. The following example shows how this can be done at a low level. See maria.View.subclass for a more compact way to accomplish the same. myapp.MyView = function() { maria.View.apply(this, arguments); }; myapp.MyView.prototype = maria.create(maria.View.prototype); myapp.MyView.prototype.constructor = myapp.MyView; myapp.MyView.prototype.getModelActions = function() { return { 'squashed': 'onSquashed', 'squished': 'onSquished' }; }; maria.MyView.prototype.onSquished = function(evt) { this.getController().onSquished(evt); }; maria.MyView.prototype.onSquashed = function() { this.getController().onSquashed(evt); }; myapp.MyView.prototype.getDefaultControllerConstructor = function() { return myapp.MyController; }; myapp.MyView.prototype.anotherMethod = function() { alert('another method'); }; */ maria.View = function(model, controller) { hijos.Node.call(this); this.setModel(model); this.setController(controller); }; maria.View.prototype = maria.create(hijos.Node.prototype); maria.View.prototype.constructor = maria.View; maria.View.prototype.destroy = function() { maria.purge(this); this._model = null; if (this._controller) { this._controller.destroy(); this._controller = null; } hijos.Node.prototype.destroy.call(this); }; maria.View.prototype.update = function() { // to be overridden by concrete view subclasses }; maria.View.prototype.getModel = function() { return this._model; }; maria.View.prototype.setModel = function(model) { this._setModelAndController(model, this._controller); }; maria.View.prototype.getDefaultControllerConstructor = function() { return maria.Controller; }; maria.View.prototype.getDefaultController = function() { var constructor = this.getDefaultControllerConstructor(); return new constructor(); }; maria.View.prototype.getController = function() { if (!this._controller) { this.setController(this.getDefaultController()); } return this._controller; }; maria.View.prototype.setController = function(controller) { this._setModelAndController(this._model, controller); }; maria.View.prototype.getModelActions = function() { return {'change': 'update'}; }; maria.View.prototype._setModelAndController = function(model, controller) { var type, eventMap; if (this._model !== model) { if (this._model) { eventMap = this._lastModelActions; for (type in eventMap) { if (Object.prototype.hasOwnProperty.call(eventMap, type)) { maria.off(this._model, type, this, eventMap[type]); } } delete this._lastModelActions; } if (model) { eventMap = this._lastModelActions = this.getModelActions() || {}; for (type in eventMap) { if (Object.prototype.hasOwnProperty.call(eventMap, type)) { maria.on(model, type, this, eventMap[type]); } } } this._model = model; } if (controller) { controller.setView(this); controller.setModel(model); } this._controller = controller; }; /** @property maria.ElementView @parameter model {Object} Optional @parameter controller {Object} Optional @parameter document {Document} Optional @description A constructor function to create new element view objects. var elementView = new maria.ElementView(); This constructor function takes three optional arguments. var model = new maria.Model(); var controller = new maria.Controller(); var myFrameDoc = window.frames['myFrame'].document; var elementView = new maria.ElementView(model, controller, myFrameDoc); The null or undefined value can be passed for any of these three parameters to skip setting it. The purpose of the third document parameter is to allow the creation of element views in one window that will be shown in another window. At least some older browsers do not allow a DOM element created with one document object to be appended to another document object. An element view is a view (inheriting from maria.View) and so has a model and controller. See maria.View for more documentation about setting and getting the model and controller objects. What makes maria.ElementView different from the more abstract maria.View is that an element view has the concept of a "root element" which is the main DOM element that acts as a container for all the other DOM elements that are part of the element view. The DOM is built using the getTemplate method which should return a fragment of HTML for a single DOM element and its children. By default the template is just an empty div element. You can redefine or override this to suit your needs. maria.ElementView.prototype.getTemplate = function() { return '