472 lines
18 KiB
JavaScript
472 lines
18 KiB
JavaScript
/*
|
|
|
|
Copyright 2008-2013 Clipperz Srl
|
|
|
|
This file is part of Clipperz, the online password manager.
|
|
For further information about its features and functionalities please
|
|
refer to http://www.clipperz.com.
|
|
|
|
* Clipperz is free software: you can redistribute it and/or modify it
|
|
under the terms of the GNU Affero General Public License as published
|
|
by the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
* Clipperz is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
See the GNU Affero General Public License for more details.
|
|
|
|
* You should have received a copy of the GNU Affero General Public
|
|
License along with Clipperz. If not, see http://www.gnu.org/licenses/.
|
|
|
|
*/
|
|
|
|
if (typeof(Clipperz) == 'undefined') { Clipperz = {}; }
|
|
if (typeof(Clipperz.YUI) == 'undefined') { Clipperz.YUI = {}; }
|
|
|
|
|
|
/**
|
|
* @class Clipperz.ext.DomHelper
|
|
* Utility class for working with DOM and/or Templates. It transparently supports using HTML fragments or DOM.
|
|
* For more information see <a href="http://www.jackslocum.com/yui/2006/10/06/domhelper-create-elements-using-dom-html-fragments-or-templates/">this blog post with examples</a>.
|
|
* @singleton
|
|
*/
|
|
Clipperz.YUI.DomHelper = new function(){
|
|
/**@private*/
|
|
var d = document;
|
|
var tempTableEl = null;
|
|
/** True to force the use of DOM instead of html fragments @type Boolean */
|
|
this.useDom = false;
|
|
var emptyTags = /^(?:base|basefont|br|frame|hr|img|input|isindex|link|meta|nextid|range|spacer|wbr|audioscope|area|param|keygen|col|limittext|spot|tab|over|right|left|choose|atop|of)$/i;
|
|
/**
|
|
* Applies a style specification to an element
|
|
* @param {String/HTMLElement} el The element to apply styles to
|
|
* @param {String/Object/Function} styles A style specification string eg "width:100px", or object in the form {width:"100px"}, or
|
|
* a function which returns such a specification.
|
|
*/
|
|
this.applyStyles = function(el, styles){
|
|
if(styles){
|
|
var D = YAHOO.util.Dom;
|
|
if (typeof styles == "string"){
|
|
var re = /\s?([a-z\-]*)\:([^;]*);?/gi;
|
|
var matches;
|
|
while ((matches = re.exec(styles)) != null){
|
|
D.setStyle(el, matches[1], matches[2]);
|
|
}
|
|
}else if (typeof styles == "object"){
|
|
for (var style in styles){
|
|
D.setStyle(el, style, styles[style]);
|
|
}
|
|
}else if (typeof styles == "function"){
|
|
Clipperz.YUI.DomHelper.applyStyles(el, styles.call());
|
|
}
|
|
}
|
|
};
|
|
|
|
// build as innerHTML where available
|
|
/** @ignore */
|
|
var createHtml = function(o){
|
|
var b = '';
|
|
|
|
if(typeof(o['html']) != 'undefined') {
|
|
o['html'] = Clipperz.Base.sanitizeString(o['html']);
|
|
} else if (typeof(o['htmlString']) != 'undefined') {
|
|
o['html'] = o['htmlString'];
|
|
delete o.htmlString;
|
|
}
|
|
|
|
if (MochiKit.Base.isArrayLike(o)) {
|
|
for (var i = 0, l = o.length; i < l; i++) {
|
|
b += createHtml(o[i]);
|
|
}
|
|
return b;
|
|
}
|
|
|
|
b += '<' + o.tag;
|
|
for(var attr in o){
|
|
if(attr == 'tag' || attr == 'children' || attr == 'html' || typeof o[attr] == 'function') continue;
|
|
if(attr == 'style'){
|
|
var s = o['style'];
|
|
if(typeof s == 'function'){
|
|
s = s.call();
|
|
}
|
|
if(typeof s == 'string'){
|
|
b += ' style="' + s + '"';
|
|
}else if(typeof s == 'object'){
|
|
b += ' style="';
|
|
for(var key in s){
|
|
if(typeof s[key] != 'function'){
|
|
b += key + ':' + s[key] + ';';
|
|
}
|
|
}
|
|
b += '"';
|
|
}
|
|
}else{
|
|
if(attr == 'cls'){
|
|
b += ' class="' + o['cls'] + '"';
|
|
}else if(attr == 'htmlFor'){
|
|
b += ' for="' + o['htmlFor'] + '"';
|
|
}else{
|
|
b += ' ' + attr + '="' + o[attr] + '"';
|
|
}
|
|
}
|
|
}
|
|
if(emptyTags.test(o.tag)){
|
|
b += ' />';
|
|
}else{
|
|
b += '>';
|
|
if(o.children){
|
|
for(var i = 0, len = o.children.length; i < len; i++) {
|
|
b += createHtml(o.children[i], b);
|
|
}
|
|
}
|
|
if(o.html){
|
|
b += o.html;
|
|
}
|
|
b += '</' + o.tag + '>';
|
|
}
|
|
return b;
|
|
}
|
|
|
|
// build as dom
|
|
/** @ignore */
|
|
var createDom = function(o, parentNode){
|
|
var el = d.createElement(o.tag);
|
|
var useSet = el.setAttribute ? true : false; // In IE some elements don't have setAttribute
|
|
for(var attr in o){
|
|
if(attr == 'tag' || attr == 'children' || attr == 'html' || attr == 'style' || typeof o[attr] == 'function') continue;
|
|
if(attr=='cls'){
|
|
el.className = o['cls'];
|
|
}else{
|
|
if(useSet) el.setAttribute(attr, o[attr]);
|
|
else el[attr] = o[attr];
|
|
}
|
|
}
|
|
Clipperz.YUI.DomHelper.applyStyles(el, o.style);
|
|
if(o.children){
|
|
for(var i = 0, len = o.children.length; i < len; i++) {
|
|
createDom(o.children[i], el);
|
|
}
|
|
}
|
|
if(o.html){
|
|
el.innerHTML = o.html;
|
|
}
|
|
if(parentNode){
|
|
parentNode.appendChild(el);
|
|
}
|
|
return el;
|
|
};
|
|
|
|
/**
|
|
* @ignore
|
|
* Nasty code for IE's broken table implementation
|
|
*/
|
|
var insertIntoTable = function(tag, where, el, html){
|
|
if(!tempTableEl){
|
|
tempTableEl = document.createElement('div');
|
|
}
|
|
var nodes;
|
|
if(tag == 'table' || tag == 'tbody'){
|
|
tempTableEl.innerHTML = '<table><tbody>'+html+'</tbody></table>';
|
|
nodes = tempTableEl.firstChild.firstChild.childNodes;
|
|
}else{
|
|
tempTableEl.innerHTML = '<table><tbody><tr>'+html+'</tr></tbody></table>';
|
|
nodes = tempTableEl.firstChild.firstChild.firstChild.childNodes;
|
|
}
|
|
if (where == 'beforebegin') {
|
|
nodes.reverse();
|
|
// el.parentNode.insertBefore(node, el);
|
|
MochiKit.Base.map(function(aNode) {el.parentNode.insertBefore(aNode, el)}, nodes);
|
|
} else if (where == 'afterbegin') {
|
|
nodes.reverse();
|
|
// el.insertBefore(node, el.firstChild);
|
|
MochiKit.Base.map(function(aNode) {el.insertBefore(aNode, el.firstChild)}, nodes);
|
|
} else if (where == 'beforeend') {
|
|
// el.appendChild(node);
|
|
MochiKit.Base.map(function(aNode) {el.appendChild(aNode)}, nodes);
|
|
} else if (where == 'afterend') {
|
|
// el.parentNode.insertBefore(node, el.nextSibling);
|
|
MochiKit.Base.map(function(aNode) {el.parentNode.insertBefore(aNode, el.nextSibling)}, nodes);
|
|
}
|
|
|
|
return nodes;
|
|
}
|
|
|
|
/**
|
|
* Inserts an HTML fragment into the Dom
|
|
* @param {String} where Where to insert the html in relation to el - beforeBegin, afterBegin, beforeEnd, afterEnd.
|
|
* @param {HTMLElement} el The context element
|
|
* @param {String} html The HTML fragmenet
|
|
* @return {HTMLElement} The new node
|
|
*/
|
|
this.insertHtml = function(where, el, html){
|
|
where = where.toLowerCase();
|
|
// if(el.insertAdjacentHTML){
|
|
if(Clipperz_IEisBroken){
|
|
var tag = el.tagName.toLowerCase();
|
|
if(tag == 'table' || tag == 'tbody' || tag == 'tr'){
|
|
return insertIntoTable(tag, where, el, html);
|
|
}
|
|
switch(where){
|
|
case 'beforebegin':
|
|
el.insertAdjacentHTML(where, html);
|
|
return el.previousSibling;
|
|
case 'afterbegin':
|
|
el.insertAdjacentHTML(where, html);
|
|
return el.firstChild;
|
|
case 'beforeend':
|
|
el.insertAdjacentHTML(where, html);
|
|
return el.lastChild;
|
|
case 'afterend':
|
|
el.insertAdjacentHTML(where, html);
|
|
return el.nextSibling;
|
|
}
|
|
throw 'Illegal insertion point -> "' + where + '"';
|
|
}
|
|
var range = el.ownerDocument.createRange();
|
|
var frag;
|
|
switch(where){
|
|
case 'beforebegin':
|
|
range.setStartBefore(el);
|
|
frag = range.createContextualFragment(html);
|
|
el.parentNode.insertBefore(frag, el);
|
|
return el.previousSibling;
|
|
case 'afterbegin':
|
|
if(el.firstChild){ // faster
|
|
range.setStartBefore(el.firstChild);
|
|
}else{
|
|
range.selectNodeContents(el);
|
|
range.collapse(true);
|
|
}
|
|
frag = range.createContextualFragment(html);
|
|
el.insertBefore(frag, el.firstChild);
|
|
return el.firstChild;
|
|
case 'beforeend':
|
|
if(el.lastChild){
|
|
range.setStartAfter(el.lastChild); // faster
|
|
}else{
|
|
range.selectNodeContents(el);
|
|
range.collapse(false);
|
|
}
|
|
frag = range.createContextualFragment(html);
|
|
el.appendChild(frag);
|
|
return el.lastChild;
|
|
case 'afterend':
|
|
range.setStartAfter(el);
|
|
frag = range.createContextualFragment(html);
|
|
el.parentNode.insertBefore(frag, el.nextSibling);
|
|
return el.nextSibling;
|
|
}
|
|
throw 'Illegal insertion point -> "' + where + '"';
|
|
};
|
|
|
|
/**
|
|
* Creates new Dom element(s) and inserts them before el
|
|
* @param {String/HTMLElement/Element} el The context element
|
|
* @param {Object} o The Dom object spec (and children)
|
|
* @param {<i>Boolean</i>} returnElement (optional) true to return a YAHOO.Element
|
|
* @return {HTMLElement} The new node
|
|
*/
|
|
this.insertBefore = function(el, o, returnElement){
|
|
el = el.dom ? el.dom : YAHOO.util.Dom.get(el);
|
|
var newNode;
|
|
if(this.useDom){
|
|
newNode = createDom(o, null);
|
|
el.parentNode.insertBefore(newNode, el);
|
|
}else{
|
|
var html = createHtml(o);
|
|
newNode = this.insertHtml('beforeBegin', el, html);
|
|
}
|
|
return returnElement ? YAHOO.Element.get(newNode, true) : newNode;
|
|
};
|
|
|
|
/**
|
|
* Creates new Dom element(s) and inserts them after el
|
|
* @param {String/HTMLElement/Element} el The context element
|
|
* @param {Object} o The Dom object spec (and children)
|
|
* @param {<i>Boolean</i>} returnElement (optional) true to return a YAHOO.Element
|
|
* @return {HTMLElement} The new node
|
|
*/
|
|
this.insertAfter = function(el, o, returnElement){
|
|
el = el.dom ? el.dom : YAHOO.util.Dom.get(el);
|
|
var newNode;
|
|
if(this.useDom){
|
|
newNode = createDom(o, null);
|
|
el.parentNode.insertBefore(newNode, el.nextSibling);
|
|
}else{
|
|
var html = createHtml(o);
|
|
newNode = this.insertHtml('afterEnd', el, html);
|
|
}
|
|
return returnElement ? YAHOO.Element.get(newNode, true) : newNode;
|
|
};
|
|
|
|
/**
|
|
* Creates new Dom element(s) and appends them to el
|
|
* @param {String/HTMLElement/Element} el The context element
|
|
* @param {Object} o The Dom object spec (and children)
|
|
* @param {<i>Boolean</i>} returnElement (optional) true to return a YAHOO.Element
|
|
* @return {HTMLElement} The new node
|
|
*/
|
|
this.append = function(el, o, returnElement){
|
|
el = el.dom ? el.dom : YAHOO.util.Dom.get(el);
|
|
var newNode;
|
|
if(this.useDom){
|
|
newNode = createDom(o, null);
|
|
el.appendChild(newNode);
|
|
}else{
|
|
var html = createHtml(o);
|
|
newNode = this.insertHtml('beforeEnd', el, html);
|
|
}
|
|
return returnElement ? YAHOO.Element.get(newNode, true) : newNode;
|
|
};
|
|
|
|
/**
|
|
* Creates new Dom element(s) and overwrites the contents of el with them
|
|
* @param {String/HTMLElement/Element} el The context element
|
|
* @param {Object} o The Dom object spec (and children)
|
|
* @param {<i>Boolean</i>} returnElement (optional) true to return a YAHOO.Element
|
|
* @return {HTMLElement} The new node
|
|
*/
|
|
this.overwrite = function(el, o, returnElement){
|
|
el = el.dom ? el.dom : YAHOO.util.Dom.get(el);
|
|
el.innerHTML = createHtml(o);
|
|
return returnElement ? YAHOO.Element.get(el.firstChild, true) : el.firstChild;
|
|
};
|
|
|
|
/**
|
|
* Creates a new Clipperz.YUI.DomHelper.Template from the Dom object spec
|
|
* @param {Object} o The Dom object spec (and children)
|
|
* @return {Clipperz.YUI.DomHelper.Template} The new template
|
|
*/
|
|
this.createTemplate = function(o){
|
|
var html = createHtml(o);
|
|
return new Clipperz.YUI.DomHelper.Template(html);
|
|
};
|
|
}();
|
|
|
|
/**
|
|
* @class Clipperz.YUI.DomHelper.Template
|
|
* Represents an HTML fragment template.
|
|
* For more information see <a href="http://www.jackslocum.com/yui/2006/10/06/domhelper-create-elements-using-dom-html-fragments-or-templates/">this blog post with examples</a>.
|
|
* <br>
|
|
* <b>This class is also available as Clipperz.YUI.Template</b>.
|
|
* @constructor
|
|
* @param {String/Array} html The HTML fragment or an array of fragments to join('') or multiple arguments to join('')
|
|
*/
|
|
Clipperz.YUI.DomHelper.Template = function(html){
|
|
if(html instanceof Array){
|
|
html = html.join('');
|
|
}else if(arguments.length > 1){
|
|
html = Array.prototype.join.call(arguments, '');
|
|
}
|
|
/**@private*/
|
|
this.html = html;
|
|
};
|
|
Clipperz.YUI.DomHelper.Template.prototype = {
|
|
/**
|
|
* Returns an HTML fragment of this template with the specified values applied
|
|
* @param {Object} values The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
|
|
* @return {String}
|
|
*/
|
|
applyTemplate : function(values){
|
|
if(this.compiled){
|
|
return this.compiled(values);
|
|
}
|
|
var empty = '';
|
|
var fn = function(match, index){
|
|
if(typeof values[index] != 'undefined'){
|
|
return values[index];
|
|
}else{
|
|
return empty;
|
|
}
|
|
}
|
|
return this.html.replace(this.re, fn);
|
|
},
|
|
|
|
/**
|
|
* The regular expression used to match template variables
|
|
* @type RegExp
|
|
* @property
|
|
*/
|
|
re : /\{([\w|-]+)\}/g,
|
|
|
|
/**
|
|
* Compiles the template into an internal function, eliminating the RegEx overhead
|
|
*/
|
|
compile : function(){
|
|
var body = ["this.compiled = function(values){ return ['"];
|
|
body.push(this.html.replace(this.re, "', values['$1'], '"));
|
|
body.push("'].join('');};");
|
|
eval(body.join(''));
|
|
return this;
|
|
},
|
|
|
|
/**
|
|
* Applies the supplied values to the template and inserts the new node(s) before el
|
|
* @param {String/HTMLElement/Element} el The context element
|
|
* @param {Object} values The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
|
|
* @param {<i>Boolean</i>} returnElement (optional) true to return a YAHOO.Element
|
|
* @return {HTMLElement} The new node
|
|
*/
|
|
insertBefore: function(el, values, returnElement){
|
|
el = el.dom ? el.dom : YAHOO.util.Dom.get(el);
|
|
var newNode = Clipperz.YUI.DomHelper.insertHtml('beforeBegin', el, this.applyTemplate(values));
|
|
return returnElement ? YAHOO.Element.get(newNode, true) : newNode;
|
|
},
|
|
|
|
/**
|
|
* Applies the supplied values to the template and inserts the new node(s) after el
|
|
* @param {String/HTMLElement/Element} el The context element
|
|
* @param {Object} values The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
|
|
* @param {<i>Boolean</i>} returnElement (optional) true to return a YAHOO.Element
|
|
* @return {HTMLElement} The new node
|
|
*/
|
|
insertAfter : function(el, values, returnElement){
|
|
el = el.dom ? el.dom : YAHOO.util.Dom.get(el);
|
|
var newNode = Clipperz.YUI.DomHelper.insertHtml('afterEnd', el, this.applyTemplate(values));
|
|
return returnElement ? YAHOO.Element.get(newNode, true) : newNode;
|
|
},
|
|
|
|
/**
|
|
* Applies the supplied values to the template and append the new node(s) to el
|
|
* @param {String/HTMLElement/Element} el The context element
|
|
* @param {Object} values The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
|
|
* @param {<i>Boolean</i>} returnElement (optional) true to return a YAHOO.Element
|
|
* @return {HTMLElement} The new node
|
|
*/
|
|
append : function(el, values, returnElement){
|
|
var sanitizedValues;
|
|
var key;
|
|
|
|
sanitizedValues = {};
|
|
for (key in values) {
|
|
sanitizedValues[key] = Clipperz.Base.sanitizeString(values[key]);
|
|
}
|
|
el = (typeof el == 'string') ? YAHOO.util.Dom.get(el) : el;
|
|
var newNode = Clipperz.YUI.DomHelper.insertHtml('beforeEnd', el, this.applyTemplate(sanitizedValues));
|
|
|
|
return newNode;
|
|
},
|
|
|
|
/**
|
|
* Applies the supplied values to the template and overwrites the content of el with the new node(s)
|
|
* @param {String/HTMLElement/Element} el The context element
|
|
* @param {Object} values The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
|
|
* @param {<i>Boolean</i>} returnElement (optional) true to return a YAHOO.Element
|
|
* @return {HTMLElement} The new node
|
|
*/
|
|
overwrite : function(el, values, returnElement){
|
|
el = el.dom ? el.dom : YAHOO.util.Dom.get(el);
|
|
el.innerHTML = '';
|
|
var newNode = Clipperz.YUI.DomHelper.insertHtml('beforeEnd', el, this.applyTemplate(values));
|
|
return returnElement ? YAHOO.Element.get(newNode, true) : newNode;
|
|
}
|
|
};
|
|
/**
|
|
* Alias for applyTemplate
|
|
* @method
|
|
*/
|
|
Clipperz.YUI.DomHelper.Template.prototype.apply = Clipperz.YUI.DomHelper.Template.prototype.applyTemplate;
|
|
|
|
Clipperz.YUI.Template = Clipperz.YUI.DomHelper.Template;
|