diff options
Diffstat (limited to 'js/pure2.js')
-rw-r--r-- | js/pure2.js | 710 |
1 files changed, 710 insertions, 0 deletions
diff --git a/js/pure2.js b/js/pure2.js new file mode 100644 index 0000000..1e0958f --- /dev/null +++ b/js/pure2.js @@ -0,0 +1,710 @@ +/* * * * * * * * * * * * * * * * * * * * * * * * * * + + PURE Unobtrusive Rendering Engine for HTML + + Licensed under the MIT licenses. + More information at: http://www.opensource.org + + Copyright (c) 2009 Michael Cvilic - BeeBole.com + + Thanks to Rog Peppe for the functional JS jump + revision: 2.18 + +* * * * * * * * * * * * * * * * * * * * * * * * * */ + +var $p, pure = $p = function(){ + var sel = arguments[0], + ctxt = false; + + if(typeof sel === 'string'){ + ctxt = arguments[1] || false; + } + return $p.core(sel, ctxt); +}; + +$p.core = function(sel, ctxt, plugins){ + //get an instance of the plugins + var plugins = getPlugins(), + templates = []; + + //search for the template node(s) + if(typeof sel === 'string'){ + templates = plugins.find(ctxt || document, sel); + }else if(typeof sel === 'object'){ + templates = [sel]; + }else{ + error('No templates found. Review your selector'); + } + + for(var i = 0, ii = templates.length; i < ii; i++){ + plugins[i] = templates[i]; + } + plugins.length = ii; + + // set the signature string that will be replaced at render time + var Sig = '_s' + Math.floor( Math.random() * 1000000 ) + '_', + // another signature to prepend to attributes and avoid checks: style, height, on[events]... + attPfx = '_a' + Math.floor( Math.random() * 1000000 ) + '_', + // rx to parse selectors, e.g. "+tr.foo[class]" + selRx = /^(\+)?([^\@\+]+)?\@?([^\+]+)?(\+)?$/, + // set automatically attributes for some tags + autoAttr = { + IMG:'src', + INPUT:'value' + }; + + return plugins; + + + /* * * * * * * * * * * * * * * * * * * * * * * * * * + core functions + * * * * * * * * * * * * * * * * * * * * * * * * * */ + + + // error utility + function error(e){ + alert(e); + if(typeof console !== 'undefined'){ + console.log(e); + debugger; + } + throw('pure error: ' + e); + } + + //return a new instance of plugins + function getPlugins(){ + var plugins = $p.plugins, + f = function(){}; + f.prototype = plugins; + + // do not overwrite functions if external definition + f.prototype.compile = plugins.compile || compile; + f.prototype.render = plugins.render || render; + f.prototype.autoRender = plugins.autoRender || autoRender; + f.prototype.find = plugins.find || find; + + // give the compiler and the error handling to the plugin context + f.prototype._compiler = compiler; + f.prototype._error = error; + + return new f(); + } + + // returns the outer HTML of a node + function outerHTML(node){ + // if IE take the internal method otherwise build one + return node.outerHTML || ( + function(n){ + var div = document.createElement('div'), h; + div.appendChild( n.cloneNode(true) ); + h = div.innerHTML; + div = null; + return h; + })(node); + } + + // check if the argument is an array + function isArray(o){ + return Object.prototype.toString.call( o ) === "[object Array]"; + } + + // returns the string generator function + function wrapquote(qfn, f){ + return function(ctxt){ + return qfn('' + f(ctxt)); + }; + } + + // convert a JSON HTML structure to a dom node and returns the leaf + function domify(ns, pa){ + pa = pa || document.createDocumentFragment(); + var nn, leaf; + for(var n in ns){ + nn = document.createElement(n); + pa.appendChild(nn); + if(typeof ns[n] === 'object'){ + leaf = domify(ns[n], nn); + }else{ + leaf = document.createElement(ns[n]); + nn.appendChild(leaf); + } + } + return leaf; + }; + + // default find using querySelector when available on the browser + function find(n, sel){ + if(typeof n === 'string'){ + sel = n; + n = false; + } + if(typeof document.querySelectorAll !== 'undefined'){ + return (n||document).querySelectorAll( sel ); + }else{ + error('You can test PURE standalone with: iPhone, FF3.5+, Safari4+ and IE8+\n\nTo run PURE on your browser, you need a JS library/framework with a CSS selector engine'); + } + } + + // create a function that concatenates constant string + // sections (given in parts) and the results of called + // functions to fill in the gaps between parts (fns). + // fns[n] fills in the gap between parts[n-1] and parts[n]; + // fns[0] is unused. + // this is the inner template evaluation loop. + function concatenator(parts, fns){ + return function(ctxt){ + var strs = [ parts[ 0 ] ], + n = parts.length, + fnVal, pVal, attLine, pos; + + for(var i = 1; i < n; i++){ + fnVal = fns[i]( ctxt ); + pVal = parts[i]; + + // if the value is empty and attribute, remove it + if(fnVal === ''){ + attLine = strs[ strs.length - 1 ]; + if( ( pos = attLine.search( /[\w]+=\"?$/ ) ) > -1){ + strs[ strs.length - 1 ] = attLine.substring( 0, pos ); + pVal = pVal.substr( 1 ); + } + } + + strs[ strs.length ] = fnVal; + strs[ strs.length ] = pVal; + } + return strs.join(''); + }; + } + + // parse and check the loop directive + function parseloopspec(p){ + var m = p.match( /^(\w+)\s*<-\s*(\S+)?$/ ); + if(m === null){ + error('bad loop spec: "' + p + '"'); + } + if(m[1] === 'item'){ + error('"item<-..." is a reserved word for the current running iteration.\n\nPlease choose another name for your loop.'); + } + if( !m[2] ){ //undefined or space(IE) + m[2] = function(ctxt){return ctxt.data;}; + } + return {name: m[1], sel: m[2]}; + } + + // parse a data selector and return a function that + // can traverse the data accordingly, given a context. + function dataselectfn(sel){ + if(typeof(sel) === 'function'){ + return sel; + } + //check for a valid js variable name with hyphen(for properties only) and $ + var m = sel.match(/^[a-zA-Z$_][\w$]*(\.[\w$-]*[^\.])*$/); + if(m === null){ + var found = false, s = sel, parts = [], pfns = [], i = 0, retStr; + // check if literal + if(/\'|\"/.test( s.charAt(0) )){ + if(/\'|\"/.test( s.charAt(s.length-1) )){ + retStr = s.substring(1, s.length-1); + return function(){ return retStr; }; + } + }else{ + // check if literal + #{var} + while((m = s.match(/#\{([^{}]+)\}/)) !== null){ + found = true; + parts[i++] = s.slice(0, m.index); + pfns[i] = dataselectfn(m[1]); + s = s.slice(m.index + m[0].length, s.length); + } + } + if(!found){ + error('bad data selector syntax: ' + sel); + } + parts[i] = s; + return concatenator(parts, pfns); + } + m = sel.split('.'); + return function(ctxt){ + var data = ctxt.data; + if(!data){ + return ''; + } + var v = ctxt[m[0]], + i = 0; + if(v){ + data = v.item; + i += 1; + } + var n = m.length; + for(; i < n; i++){ + if(!data){break;} + data = data[m[i]]; + } + return (!data && data !== 0) ? '':data; + }; + } + + // wrap in an object the target node/attr and their properties + function gettarget(dom, sel, isloop){ + var osel, prepend, selector, attr, append, target = []; + if( typeof sel === 'string' ){ + osel = sel; + var m = sel.match(selRx); + if( !m ){ + error( 'bad selector syntax: ' + sel ); + } + + prepend = m[1]; + selector = m[2]; + attr = m[3]; + append = m[4]; + + if(selector === '.' || ( !selector && attr ) ){ + target[0] = dom; + }else{ + target = plugins.find(dom, selector); + } + if(!target || target.length === 0){ + return {attr: null, nodes: target, set: null, sel: osel}; + } + }else{ + // autoRender node + prepend = sel.prepend; + attr = sel.attr; + append = sel.append; + target = [dom]; + } + + if( prepend || append ){ + if( prepend && append ){ + error('append/prepend cannot take place at the same time'); + }else if( isloop ){ + error('no append/prepend/replace modifiers allowed for loop target'); + }else if( append && isloop ){ + error('cannot append with loop (sel: ' + osel + ')'); + } + } + var setstr, getstr, quotefn, isStyle, isClass, an; + if(attr){ + isStyle = (/^style$/i).test(attr); + isClass = (/^class$/i).test(attr); + attName = isClass ? 'className' : attr; + setstr = function(node, s){ + node.setAttribute( attPfx + attr, s ); + if(attName in node && !isStyle){ + node[ attName ] = '' ; + } + if(node.nodeType === 1){ + node.removeAttribute( attr ); + } + }; + if( isStyle ){ + getstr = function(node){ return node.style.cssText;}; + }else{ + getstr = function(node){ return node.getAttribute(attr);}; + } + if( isStyle || isClass ){//IE no quotes special care + quotefn = function(s){ return s.replace(/\"/g, '"');}; + }else{ + quotefn = function(s){ return s.replace(/\"/g, '"').replace(/\s/g, ' ');}; + } + }else{ + if(isloop){ + setstr = function(node, s){ + // we can have a null parent node + // if we get overlapping targets. + var pn = node.parentNode; + if(pn){ + //replace node with s + var t = document.createTextNode(s); + node.parentNode.insertBefore(t, node.nextSibling); + node.parentNode.removeChild(node); + } + }; + }else{ + getstr = function(node){ return node.innerHTML; }; + setstr = function(node, s){ node.innerHTML = s; }; + } + quotefn = function(s){ return s; }; + } + var setfn; + if(prepend){ + setfn = function(node, s){ setstr( node, s + getstr( node ) );}; + }else if(append){ + setfn = function(node, s){ setstr( node, getstr( node ) + s );}; + }else{ + setfn = function(node, s){ setstr( node, s );}; + } + return {attr: attr, nodes: target, set: setfn, sel: osel, quotefn: quotefn}; + } + + function setsig(target, n){ + var sig = Sig + n + ':'; + for(var i = 0; i < target.nodes.length; i++){ + // could check for overlapping targets here. + target.set( target.nodes[i], sig ); + } + } + + // read de loop data, and pass it to the inner rendering function + function loopfn(name, dselect, inner){ + return function(ctxt){ + var a = dselect(ctxt), + old = ctxt[name], + temp = { items : a }, + strs = [], + buildArg = function(idx){ + ctxt.items = a; + ctxt.pos = temp.pos = idx; + ctxt.item = temp.item = a[ idx ]; + strs.push( inner( ctxt ) ); + }; + ctxt[name] = temp; + if( isArray(a) ){ + //loop on array + for(var i = 0, ii = a.length || 0; i < ii; i++){ + buildArg(i); + } + }else{ + //loop on collections + for(var prop in a){ + a.hasOwnProperty( prop ) && buildArg(prop); + } + } + typeof old !== 'undefined' ? ctxt[name] = old : delete ctxt[name]; + return strs.join(''); + }; + } + // generate the template for a loop node + function loopgen(dom, sel, loop, fns){ + var already = false; + var p; + for(var i in loop){ + if(loop.hasOwnProperty(i)){ + if(already){ + error('cannot have more than one loop on a target'); + } + p = i; + already = true; + } + } + if(!p){ + error('no loop spec'); + } + var dsel = loop[p]; + // if it's a simple data selector then we default to contents, not replacement. + if(typeof(dsel) === 'string' || typeof(dsel) === 'function'){ + loop = {}; + loop[p] = {root: dsel}; + return loopgen(dom, sel, loop, fns); + } + var spec = parseloopspec(p), + itersel = dataselectfn(spec.sel), + target = gettarget(dom, sel, true), + nodes = target.nodes; + + for(i = 0; i < nodes.length; i++){ + // could check for overlapping loop targets here by checking that + // root is still ancestor of node. + var node = nodes[i], + inner = compiler(node, dsel); + fns[fns.length] = wrapquote(target.quotefn, loopfn(spec.name, itersel, inner)); + target.nodes = [node]; // N.B. side effect on target. + setsig(target, fns.length - 1); + } + } + + function getAutoNodes(n, data){ + var ns = n.getElementsByTagName('*'), + an = [], + openLoops = {a:[],l:{}}, + cspec, + isNodeValue, + i, ii, j, jj, ni, cs, cj; + //for each node found in the template + for(i = -1, ii = ns.length; i < ii; i++){ + ni = i > -1 ?ns[i]:n; + if(ni.nodeType === 1 && ni.className !== ''){ + //when a className is found + cs = ni.className.split(' '); + // for each className + for(j = 0, jj=cs.length;j<jj;j++){ + cj = cs[j]; + // check if it is related to a context property + cspec = checkClass(cj, ni.tagName); + // if so, store the node, plus the type of data + if(cspec !== false){ + isNodeValue = (/nodevalue/i).test(cspec.attr); + if(cspec.sel.indexOf('@') > -1 || isNodeValue){ + ni.className = ni.className.replace('@'+cspec.attr, ''); + if(isNodeValue){ + cspec.attr = false; + } + } + an.push({n:ni, cspec:cspec}); + } + } + } + } + return an; + + function checkClass(c, tagName){ + // read the class + var ca = c.match(selRx), + attr = ca[3] || autoAttr[tagName], + cspec = {prepend:!!ca[1], prop:ca[2], attr:attr, append:!!ca[4], sel:c}, + val = isArray(data) ? data[0][cspec.prop] : data[cspec.prop], + i, ii, loopi; + // if first level of data is found + if(typeof val === 'undefined'){ + // check in existing open loops + for(i = openLoops.a.length-1; i >= 0; i--){ + loopi = openLoops.a[i]; + val = loopi.l[0][cspec.prop]; + if(typeof val !== 'undefined'){ + cspec.prop = loopi.p + '.' + cspec.prop; + if(openLoops.l[cspec.prop] === true){ + val = val[0]; + } + break; + } + } + } + // nothing found return + if(typeof val === 'undefined'){ + return false; + } + // set the data type and details + if(isArray(val)){ + openLoops.a.push( {l:val, p:cspec.prop} ); + openLoops.l[cspec.prop] = true; + cspec.t = 'loop'; + }else{ + cspec.t = 'str'; + } + return cspec; + } + } + + // returns a function that, given a context argument, + // will render the template defined by dom and directive. + function compiler(dom, directive, data, ans){ + var fns = []; + // autoRendering nodes parsing -> auto-nodes + ans = ans || data && getAutoNodes(dom, data); + if(data){ + var j, jj, cspec, n, target, nodes, itersel, node, inner; + // for each auto-nodes + while(ans.length > 0){ + cspec = ans[0].cspec; + n = ans[0].n; + ans.splice(0, 1); + if(cspec.t === 'str'){ + // if the target is a value + target = gettarget(n, cspec, false); + setsig(target, fns.length); + fns[fns.length] = wrapquote(target.quotefn, dataselectfn(cspec.prop)); + }else{ + // if the target is a loop + itersel = dataselectfn(cspec.sel); + target = gettarget(n, cspec, true); + nodes = target.nodes; + for(j = 0, jj = nodes.length; j < jj; j++){ + node = nodes[j]; + inner = compiler(node, false, data, ans); + fns[fns.length] = wrapquote(target.quotefn, loopfn(cspec.sel, itersel, inner)); + target.nodes = [node]; + setsig(target, fns.length - 1); + } + } + } + } + // read directives + var target, dsel; + for(var sel in directive){ + if(directive.hasOwnProperty(sel)){ + dsel = directive[sel]; + if(typeof(dsel) === 'function' || typeof(dsel) === 'string'){ + // set the value for the node/attr + target = gettarget(dom, sel, false); + setsig(target, fns.length); + fns[fns.length] = wrapquote(target.quotefn, dataselectfn(dsel)); + }else{ + // loop on node + loopgen(dom, sel, dsel, fns); + } + } + } + // convert node to a string + var h = outerHTML(dom), pfns = []; + // IE adds an unremovable "selected" attribute + // hard replace while waiting for a better solution + if (dom.tagName === 'OPTION' && (new RegExp(attPfx + 'selected', 'i')).test(h)) { + h = h.replace(/\sselected\s/, ' '); + } + // remove attribute prefix + h = h.split(attPfx).join(''); + + // slice the html string at "Sig" + var parts = h.split( Sig ), p; + // for each slice add the return string of + for(var i = 1; i < parts.length; i++){ + p = parts[i]; + // part is of the form "fn-number:..." as placed there by setsig. + pfns[i] = fns[ parseInt(p, 10) ]; + parts[i] = p.substring( p.indexOf(':') + 1 ); + } + return concatenator(parts, pfns); + } + // compile the template with directive + // if a context is passed, the autoRendering is triggered automatically + // return a function waiting the data as argument + function compile(directive, ctxt, template){ + var rfn = compiler( ( template || this[0] ).cloneNode(true), directive, ctxt); + return function(data, context){ + context = context || data; + return rfn({data: data, context:context}); + }; + } + //compile with the directive as argument + // run the template function on the context argument + // return an HTML string + // should replace the template and return this + function render(ctxt, directive){ + var fn = typeof directive === 'function' ? directive : plugins.compile( directive, false, this[0] ); + for(var i = 0, ii = this.length; i < ii; i++){ + this[i] = replaceWith( this[i], fn( ctxt, false )); + } + context = null; + return this; + } + + // compile the template with autoRender + // run the template function on the context argument + // return an HTML string + function autoRender(ctxt, directive){ + var fn = plugins.compile( directive, ctxt, this[0] ); + for(var i = 0, ii = this.length; i < ii; i++){ + this[i] = replaceWith( this[i], fn( ctxt, false)); + } + context = null; + return this; + } + + function replaceWith(elm, html){ + var div = document.createElement('DIV'), + tagName = elm.tagName.toLowerCase(), + ne, pa; + if((/td|tr|th/).test(tagName)){ + var parents = { tr:{table:'tbody'}, td:{table:{tbody:'tr'}}, th:{table:{thead:'tr'}} }; + pa = domify( parents[ tagName ] ); + }else if( ( /tbody|thead|tfoot/ ).test( tagName )){ + pa = document.createElement('table'); + }else{ + pa = document.createElement('div'); + } + + var ep = elm.parentNode; + // avoid IE mem leak + ep.insertBefore(pa, elm); + ep.removeChild(elm); + pa.innerHTML = html; + ne = pa.firstChild; + ep.insertBefore(ne, pa); + ep.removeChild(pa); + elm = ne; + + pa = ne = ep = null; + return elm; + } +}; + +$p.plugins = {}; + +$p.libs = { + dojo:function(){ + if(typeof document.querySelector === 'undefined'){ + $p.plugins.find = function(n, sel){ + return dojo.query(sel, n); + }; + } + }, + domassistant:function(){ + if(typeof document.querySelector === 'undefined'){ + $p.plugins.find = function(n, sel){ + return $(n).cssSelect(sel); + }; + } + DOMAssistant.attach({ + publicMethods : [ 'compile', 'render', 'autoRender'], + compile:function(directive, ctxt){ return $p(this).compile(directive, ctxt); }, + render:function(ctxt, directive){ return $( $p(this).render(ctxt, directive) )[0]; }, + autoRender:function(ctxt, directive){ return $( $p(this).autoRender(ctxt, directive) )[0]; } + }); + }, + jquery:function(){ + if(typeof document.querySelector === 'undefined'){ + $p.plugins.find = function(n, sel){ + return $(n).find(sel); + }; + } + jQuery.fn.extend({ + compile:function(directive, ctxt){ return $p(this[0]).compile(directive, ctxt); }, + render:function(ctxt, directive){ return jQuery( $p( this[0] ).render( ctxt, directive ) ); }, + autoRender:function(ctxt, directive){ return jQuery( $p( this[0] ).autoRender( ctxt, directive ) ); } + }); + }, + mootools:function(){ + if(typeof document.querySelector === 'undefined'){ + $p.plugins.find = function(n, sel){ + return $(n).getElements(sel); + }; + } + Element.implement({ + compile:function(directive, ctxt){ return $p(this).compile(directive, ctxt); }, + render:function(ctxt, directive){ return $p(this).render(ctxt, directive); }, + autoRender:function(ctxt, directive){ return $p(this).autoRender(ctxt, directive); } + }); + }, + prototype:function(){ + if(typeof document.querySelector === 'undefined'){ + $p.plugins.find = function(n, sel){ + n = n === document ? n.body : n; + return typeof n === 'string' ? $$(n) : $(n).select(sel); + }; + } + Element.addMethods({ + compile:function(element, directive, ctxt){ return $p(element).compile(directive, ctxt); }, + render:function(element, ctxt, directive){ return $p(element).render(ctxt, directive); }, + autoRender:function(element, ctxt, directive){ return $p(element).autoRender(ctxt, directive); } + }); + }, + sizzle:function(){ + if(typeof document.querySelector === 'undefined'){ + $p.plugins.find = function(n, sel){ + return Sizzle(sel, n); + }; + } + }, + sly:function(){ + if(typeof document.querySelector === 'undefined'){ + $p.plugins.find = function(n, sel){ + return Sly(sel, n); + }; + } + } +}; + +// get lib specifics if available +(function(){ + var libkey = + typeof dojo !== 'undefined' && 'dojo' || + typeof DOMAssistant !== 'undefined' && 'domassistant' || + typeof jQuery !== 'undefined' && 'jquery' || + typeof MooTools !== 'undefined' && 'mootools' || + typeof Prototype !== 'undefined' && 'prototype' || + typeof Sizzle !== 'undefined' && 'sizzle' || + typeof Sly !== 'undefined' && 'sly'; + + libkey && $p.libs[libkey](); +})();
\ No newline at end of file |