@qooxdoo/framework
Version:
The JS Framework for Coders
287 lines (250 loc) • 7.82 kB
JavaScript
/* ************************************************************************
qooxdoo - the new era of web development
http://qooxdoo.org
Copyright:
2004-2008 1&1 Internet AG, Germany, http://www.1und1.de
License:
MIT: https://opensource.org/licenses/MIT
See the LICENSE file in the project's top-level directory for details.
Authors:
* Sebastian Werner (wpbasti)
************************************************************************ */
/**
* Basic node creation and type detection
*/
qx.Bootstrap.define("qx.dom.Node", {
/*
*****************************************************************************
STATICS
*****************************************************************************
*/
statics: {
/*
---------------------------------------------------------------------------
NODE TYPES
---------------------------------------------------------------------------
*/
/**
* @type {Map} Node type:
*
* * ELEMENT
* * ATTRIBUTE
* * TEXT
* * CDATA_SECTION
* * ENTITY_REFERENCE
* * ENTITY
* * PROCESSING_INSTRUCTION
* * COMMENT
* * DOCUMENT
* * DOCUMENT_TYPE
* * DOCUMENT_FRAGMENT
* * NOTATION
*/
ELEMENT: 1,
ATTRIBUTE: 2,
TEXT: 3,
CDATA_SECTION: 4,
ENTITY_REFERENCE: 5,
ENTITY: 6,
PROCESSING_INSTRUCTION: 7,
COMMENT: 8,
DOCUMENT: 9,
DOCUMENT_TYPE: 10,
DOCUMENT_FRAGMENT: 11,
NOTATION: 12,
/*
---------------------------------------------------------------------------
DOCUMENT ACCESS
---------------------------------------------------------------------------
*/
/**
* Returns the owner document of the given node
*
* @param node {Node|Document|Window} the node which should be tested
* @return {Document|null} The document of the given DOM node
*/
getDocument(node) {
return node.nodeType === this.DOCUMENT
? node // is document already
: node.ownerDocument || // is DOM node
node.document; // is window
},
/**
* Returns the DOM2 <code>defaultView</code> (window).
*
* @param node {Node|Document|Window} node to inspect
* @return {Window} the <code>defaultView</code> of the given node
*/
getWindow(node) {
// is a window already
if (node.nodeType == null) {
return node;
}
// jump to document
if (node.nodeType !== this.DOCUMENT) {
node = node.ownerDocument;
}
// jump to window
return node.defaultView || node.parentWindow;
},
/**
* Returns the document element. (Logical root node)
*
* This is a convenience attribute that allows direct access to the child
* node that is the root element of the document. For HTML documents,
* this is the element with the tagName "HTML".
*
* @param node {Node|Document|Window} node to inspect
* @return {Element} document element of the given node
*/
getDocumentElement(node) {
return this.getDocument(node).documentElement;
},
/**
* Returns the body element. (Visual root node)
*
* This normally only makes sense for HTML documents. It returns
* the content area of the HTML document.
*
* @param node {Node|Document|Window} node to inspect
* @return {Element} document body of the given node
*/
getBodyElement(node) {
return this.getDocument(node).body;
},
/*
---------------------------------------------------------------------------
TYPE TESTS
---------------------------------------------------------------------------
*/
/**
* Whether the given object is a DOM node
*
* @param node {Node} the node which should be tested
* @return {Boolean} true if the node is a DOM node
*/
isNode(node) {
return !!(node && node.nodeType != null);
},
/**
* Whether the given object is a DOM element node
*
* @param node {Node} the node which should be tested
* @return {Boolean} true if the node is a DOM element
*/
isElement(node) {
return !!(node && node.nodeType === this.ELEMENT);
},
/**
* Whether the given object is a DOM document node
*
* @param node {Node} the node which should be tested
* @return {Boolean} true when the node is a DOM document
*/
isDocument(node) {
return !!(node && node.nodeType === this.DOCUMENT);
},
/**
* Whether the given object is a DOM document fragment node
*
* @param node {Node} the node which should be tested
* @return {Boolean} true when the node is a DOM document fragment
*/
isDocumentFragment(node) {
return !!(node && node.nodeType === this.DOCUMENT_FRAGMENT);
},
/**
* Whether the given object is a DOM text node
*
* @param node {Node} the node which should be tested
* @return {Boolean} true if the node is a DOM text node
*/
isText(node) {
return !!(node && node.nodeType === this.TEXT);
},
/**
* Check whether the given object is a browser window object.
*
* @param obj {Object} the object which should be tested
* @return {Boolean} true if the object is a window object
*/
isWindow(obj) {
return !!(obj && obj.history && obj.location && obj.document);
},
/**
* Whether the node has the given node name
*
* @param node {Node} the node
* @param nodeName {String} the node name to check for
* @return {Boolean} Whether the node has the given node name
*/
isNodeName(node, nodeName) {
if (!nodeName || !node || !node.nodeName) {
return false;
}
return nodeName.toLowerCase() == qx.dom.Node.getName(node);
},
/*
---------------------------------------------------------------------------
UTILITIES
---------------------------------------------------------------------------
*/
/**
* Get the node name as lower case string
*
* @param node {Node} the node
* @return {String} the node name
*/
getName(node) {
if (!node || !node.nodeName) {
return null;
}
return node.nodeName.toLowerCase();
},
/**
* Returns the text content of an node where the node may be of node type
* NODE_ELEMENT, NODE_ATTRIBUTE, NODE_TEXT or NODE_CDATA
*
* @param node {Node} the node from where the search should start.
* If the node has subnodes the text contents are recursively retreived and joined.
* @return {String} the joined text content of the given node or null if not appropriate.
* @signature function(node)
*/
getText(node) {
if (!node || !node.nodeType) {
return null;
}
switch (node.nodeType) {
case 1: // NODE_ELEMENT
var i,
a = [],
nodes = node.childNodes,
length = nodes.length;
for (i = 0; i < length; i++) {
a[i] = this.getText(nodes[i]);
}
return a.join("");
case 2: // NODE_ATTRIBUTE
case 3: // NODE_TEXT
case 4: // CDATA
return node.nodeValue;
}
return null;
},
/**
* Checks if the given node is a block node
*
* @param node {Node} Node
* @return {Boolean} whether it is a block node
*/
isBlockNode(node) {
if (!qx.dom.Node.isElement(node)) {
return false;
}
node = qx.dom.Node.getName(node);
return /^(body|form|textarea|fieldset|ul|ol|dl|dt|dd|li|div|hr|p|h[1-6]|quote|pre|table|thead|tbody|tfoot|tr|td|th|iframe|address|blockquote)$/.test(
node
);
}
}
});