//
if (!document.getElementById || !document.createTextNode) {
return;
}
},
getLastSibling: function(node) {
/// Finds the last sibling of a DOM element node.
/// The DOM element node to find the last sibling node for.
/// A DOM element node, if existent; otherwise, null.
var o = node.parentNode.lastChild;
while (o.nodeType !== domLib.nodeTypes.ELEMENT_NODE && o.previousSibling !== null) {
o = o.previousSibling;
}
return (o.nodeType === domLib.nodeTypes.ELEMENT_NODE) ? o : null;
},
getFirstSibling: function(node) {
/// Finds the first sibling of a DOM element node.
/// The DOM element node to find the last sibling node for.
/// A DOM element node, if existent; otherwise, null.
var o = node.parentNode.firstChild;
while (o.nodeType !== domLib.nodeTypes.ELEMENT_NODE && o.nextSibling !== null) {
o = o.nextSibling;
}
return (o.nodeType === domLib.nodeTypes.ELEMENT_NODE) ? o : null;
},
getClosestSibling: function(node, direction) {
/// Finds the closest sibling of a DOM element node in the specified direction.
/// The DOM element node to find the sibling for.
/// The direction to search for (a ).
/// The closest sibling node, if existent; otherwise, null.
var o;
if (direction === domLib.directions.BACKWARD && node.previousSibling !== null) {
o = node.previousSibling;
while (o.nodeType !== domLib.nodeTypes.ELEMENT_NODE && o.previousSibling !== null) {
o = o.previousSibling;
}
}
else if (direction === domLib.directions.FORWARD && node.nextSibling !== null) {
o = node.nextSibling;
while (domLib.nodeTypes.ELEMENT_NODE !== o.nodeType && null !== o.nextSibling) {
o = o.nextSibling;
}
}
return o.nodeType === domLib.nodeTypes.ELEMENT_NODE ? o : null;
},
getText: function(node) {
/// Retrieves the nodeValue of a DOM text node.
/// The DOM node to find a text node and retrieve its nodeValue for.
/// The text node's nodeValue, if existent; otherwise, null.
if (!node.hasChildNodes()) {
return null;
}
var reg = /^\s+$/;
var o = node.firstChild;
while (o.nodeType !== domLib.nodeTypes.TEXT_NODE && o.nextSibling !== null || reg.test(o.nodeValue)) {
o = o.nextSibling;
}
return o.nodeType === domLib.nodeTypes.TEXT_NODE ? o.nodeValue : null;
},
setText: function(node, txt) {
/// Sets the nodeValue of a DOM text node.
/// The DOM node to find a text node and sets the nodeValue for.
/// The text for the text node to be set.
/// true, if the operation succeeded; otherwise, false.
if (!node.hasChildNodes()) {
return false;
}
var reg = /^\s+$/;
var o = node.firstChild;
while (o.nodeType !== domLib.nodeTypes.TEXT_NODE && o.nextSibling !== null || reg.test(o.nodeValue)) {
o = o.nextSibling;
}
if (o.nodeType === domLib.nodeTypes.TEXT_NODE) {
o.nodeValue = txt;
return true;
}
else {
return false;
}
},
createAnchor: function(uri, txt) {
/// Creates a DOM anchor element node.
/// The anchor's target URL.
/// The anchor's text.
/// The anchor element node created.
var o = document.createElement("a");
o.appendChild(document.createTextNode(txt));
o.setAttribute("href", uri);
return o;
},
createImage: function(id, uri, alt) {
/// Creates a DOM image element node.
/// The image's id attribute value.
/// The image's src attribute value.
/// The image's alt attribute value.
/// The image element node created.
var o = document.createElement("img");
o.setAttribute("id", id);
o.setAttribute("src", uri);
o.setAttribute("alt", alt);
return o;
},
createTextElement: function(name, txt) {
/// Creates a DOM element node and sets its text value.
/// The name of the DOM element node to create.
/// The element's text.
/// The element node created.
var o = document.createElement(name);
o.appendChild(document.createTextNode(txt));
return o;
},
getChildElements: function(elementNode, deep) {
/// Finds all element child nodes in the DOM, starting with the element node provided.
/// The root DOM element node
/// starting the DOM walk with.
/// Specifies whether only direct child element nodes are
/// found or a deep DOM walk is done.
/// A list of element node references.
var results = [];
if (elementNode.nodeType !== domLib.nodeTypes.ELEMENT_NODE) {
return results;
}
if (!deep) {
var node, nodes;
nodes = elementNode.childNodes;
for (node in nodes) {
if (nodes[node].nodeType === domLib.nodeTypes.ELEMENT_NODE) {
results.push(nodes[node]);
}
}
} else {
domLib.walkTheDom(elementNode, function(node) {
if (node.nodeType === domLib.nodeTypes.ELEMENT_NODE) {
results.push(node);
}
});
}
return results;
},
getElementsByClassName: function(elementNode, className) {
/// Finds all element child nodes in the DOM with the specified class property value, starting with the
/// element node provided.
/// The root DOM element node
/// starting the DOM walk with.
/// The class name or string of blank-separated class
/// names to find the element nodes for.
/// An array of element node references.
var results = [];
var nodes, i;
if (document.getElementsByClassName) {
nodes = elementNode.getElementsByClassName(className);
// Iterates the HTMLCollection of element nodes and builds up
// a JavaScript array for return type consistency
for (i = 0; i < nodes.length; i++) {
results.push(nodes[i]);
}
}
else {
if (elementNode.nodeType === domLib.nodeTypes.ELEMENT_NODE) {
domLib.walkTheDom(elementNode, function(node) {
if (domLib.manageCss(domLib.cssActions.CHECK, node, className)) {
results.push(node);
}
});
}
}
return results;
},
walkTheDom: function(node, func) {
/// Walks the DOM for the specified node, executing the function on every child node.
/// The DOM node starting the DOM walk with.
/// The function to execute on every child node.
/// In ECMAScript, Functions are first-class values and Closures are supported!
func(node);
node = node.firstChild;
while (node) {
domLib.walkTheDom(node, func);
node = node.nextSibling;
}
},
initDebug: function(rows, cols) {
/// Creates a user interface for debug output.
/// The number of rows.
/// The number of columns.
/// The debug output is a textarea inserted as first child of the document body.
if (domLib.debug) {
domLib.stopDebug();
}
domLib.debug = document.createElement("textarea");
domLib.debug.setAttribute("id", domLib.debugWindowId);
domLib.debug.setAttribute("rows", rows);
domLib.debug.setAttribute("cols", cols);
domLib.debug.style.border = "1px solid lightgrey";
domLib.debug.style.backgroundColor = "whitesmoke";
domLib.debug.style.fontFamily = "Consolas,Courier New,monospace";
domLib.debug.style.fontSize = "8pt";
domLib.debug.style.color = "green";
document.body.insertBefore(domLib.debug, document.body.firstChild);
},
setDebug: function(message) {
/// Adds a debug message to the debug output element.
/// The message to be shown.
/// The message is inserted at the top.
if (!domLib.debug) {
domLib.initDebug();
}
domLib.debug.value = message + "\n" + domLib.debug.value;
},
stopDebug: function() {
/// Removes the debug output user interface and sets the debug object to null./summary>
if (domLib.debug) {
domLib.debug.parentNode.removeChild(domLib.debug);
domLib.debug = null;
}
},
getEventKeyCode: function(e) {
/// Finds the event's keyCode property value.
/// The event object in
/// DOM 2 compliant user agents; otherwise, null.
/// The event's keyCode value
/// if available; otherwise, null.
return window.event ? window.event.keyCode : e ? e.keyCode : null;
},
getEventType: function(e) {
/// Determines the event type name.
/// The event object in
/// DOM 2 compliant user agents; otherwise, null.
/// The event's type value if available; otherwise,
/// null.
return window.event ? window.event.type : e ? e.type : null;
},
getEventTarget: function(e) {
/// Determines the event target.
/// The event object in
/// DOM 2 compliant user agents; otherwise, null.
/// The DOM element node the event is targeted to,
/// if available; otherwise, null.
var target = window.event ? window.event.srcElement : e ? e.target : null;
if (!target) {
return null;
}
while (target.nodeType !== domLib.nodeTypes.ELEMENT_NODE && target.nodeName.toLowerCase() !== "body") {
target = target.parentNode;
}
return target;
},
stopBubble: function(e) {
/// Stops event propagation
/// The event object in
/// DOM 2 compliant user agents; otherwise, null.
if (window.event) {
window.event.cancelBubble = true;
return;
}
if (e && e.stopPropagation) {
e.stopPropagation();
return;
}
},
stopDefault: function(e) {
/// Signals that any default action normally taken by the
/// implementation as a result of the event will not occur.
/// The event object in
/// DOM 2 compliant user agents; otherwise, null.
if (window.event) {
// Microsoft Internet Explorer
window.event.returnValue = false;
return;
}
if (e && e.preventDefault) {
// DOM 2
e.preventDefault();
return;
}
},
cancelClick: function(e) {
/// Cancels event propagation/bubbling and prohibits the use of a default value/action.
/// The event object in
/// DOM 2 compliant user agents; otherwise, null.
/// To suppress the default value/action only, use stopDefault().
if (window.event) {
// Microsoft Internet Explorer
window.event.cancelBubble = true;
window.event.returnValue = false;
return;
}
if (e && e.stopPropagation && e.preventDefault) {
// DOM 2 event compatible user agents
e.stopPropagation();
e.preventDefault();
return;
}
},
addEvent: function(elementNode, eventType, handler, useCapture) {
/// Binds an event handler function to an event fired on/targeted to a DOM element node.
/// The DOM element node used as event target.
/// The event name.
/// The name of the event handler function (the
/// function pointer).
/// Boolean indicating whether to
/// bind the event as it is propagating towards the target node, (event capturing), or as the
/// event bubbles upwards from the target (event bubbling).
/// true, if the event binding succeeded; otherwise, false.
if (elementNode.addEventListener) {
// DOM Level 2 compliant user agents
elementNode.addEventListener(eventType, handler, useCapture);
return true;
}
else if (elementNode.attachEvent) {
// Microsoft Internet Explorer
return elementNode.attachEvent("on" + eventType, handler);
}
else {
// DOM Level 1 compliant user agents
elementNode["on" + eventType] = handler;
return true;
}
return false;
},
fireEvent: function(eventType, eventSource) {
/// Fires an event on a DOM element node.
/// The event name.
/// The DOM element node which should fire the event.
var evt;
if (document.createEvent && (eventType.indexOf("mouse") !== -1 || eventType === "click")) {
evt = document.createEvent("MouseEvents");
evt.initMouseEvent(eventType, true, true, window, 0, 0, 0, 0, 0, false, false, false, false, 0, null);
eventSource.dispatchEvent(evt);
}
else if (document.createEvent) {
evt = document.createEvent("Events");
evt.initEvent(eventType, true, true, window, 0, 0, 0, 0, 0, false, false, false, false, 0, null);
eventSource.dispatchEvent(evt);
}
else if (document.createEventObject) {
// Microsoft Internet Explorer
evt = document.createEventObject();
eventSource.fireEvent("on" + eventType, evt);
}
},
manageCss: function(action, elementNode, class1, class2) {
/// Manage the className attribute value of a DOM element.
/// A domLib.cssAction value
/// The DOM element node for which
/// the CSS classes should be managed.
/// A class name.
/// A class name.
///
/// class2 is mandatory for domLib.cssActions.SWAP only.
var result = false;
if (elementNode.nodeType !== domLib.nodeTypes.ELEMENT_NODE) {
return result;
}
switch (action) {
case domLib.cssActions.SWAP:
// Swap class1 and class2 in className property
elementNode.className = domLib.manageCss(domLib.cssActions.CHECK, elementNode, class1) ?
elementNode.className.replace(class1, class2) :
elementNode.className.replace(class2, class1);
result = true;
break;
case domLib.cssActions.ADD:
// Add class1 to className property
if (!domLib.manageCss(domLib.cssActions.CHECK, elementNode, class1)) {
elementNode.className += (elementNode.className.length === 0) ? class1 : " " + class1;
}
result = true;
break;
case domLib.cssActions.REMOVE:
// Remove class1 from className property
var replaceString = elementNode.className.match(" " + class1) ? " " + class1 : class1;
elementNode.className = elementNode.className.replace(replaceString, "");
result = true;
break;
case domLib.cssActions.CHECK:
// Check for class1 in className property
var arr = elementNode.className.split(" ");
for (var i = 0; i < arr.length; i++) {
if (arr[i] == class1) {
result = true;
break;
}
}
break;
}
return result;
},
$: function(id) {
/// Short cut function for document.getElementById
/// The id of the DOM element to find.
/// The DOM element, if the operation succeeded; otherwise, null.
return document.getElementById(id);
}
}
// Initialize Library
domLib.addEvent(window, "load", domLib.init, false);
//]]>