build/dom/dom-base-debug.js

	dom-base-debug.js revision 48e05d4731f078dd4c07a6770b2f09e10419b7fe
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter MajorYUI.add('dom-base', function(Y) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major(function(Y) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major/**
c5aaf8bd167dc5fc4175bf9fc2d5b8067b913880Neil Madden * The DOM utility provides a cross-browser abtraction layer
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major * normalizing DOM tasks, and adds extra helper functionality
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major * for other common tasks.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major * @module dom
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major * @submodule dom-base
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major * @for DOM
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major *
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major */
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major/**
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major * Provides DOM helper methods.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major * @class DOM
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major *
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major */
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Majorvar NODE_TYPE = 'nodeType',
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    OWNER_DOCUMENT = 'ownerDocument',
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    DOCUMENT_ELEMENT = 'documentElement',
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    DEFAULT_VIEW = 'defaultView',
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    PARENT_WINDOW = 'parentWindow',
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    TAG_NAME = 'tagName',
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    PARENT_NODE = 'parentNode',
1f48f8236de7de97be1c6b9d06bef50b379c8801jenkins    FIRST_CHILD = 'firstChild',
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    PREVIOUS_SIBLING = 'previousSibling',
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    NEXT_SIBLING = 'nextSibling',
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    CONTAINS = 'contains',
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    COMPARE_DOCUMENT_POSITION = 'compareDocumentPosition',
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    EMPTY_STRING = '',
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
5d4589530d1353fdd627ab216a1cdcbcaf6b705ejenkins    documentElement = Y.config.doc.documentElement,
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    re_tag = /<([a-z]+)/i,
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter MajorY_DOM = {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    /**
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * Returns the HTMLElement with the given ID (Wrapper for document.getElementById).
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @method byId
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {String} id the id attribute
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {Object} doc optional The document to search. Defaults to current document
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @return {HTMLElement | null} The HTMLElement with the id, or null if none found.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     */
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    byId: function(id, doc) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        // handle dupe IDs and IE name collision
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        return Y_DOM.allById(id, doc)[0] || null;
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    },
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    // @deprecated
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    children: function(node, tag) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        var ret = [];
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        if (node) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            tag = tag || '*';
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            ret = Y.Selector.query('> ' + tag, node);
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        }
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        return ret;
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    },
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    // @deprecated
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    firstByTag: function(tag, root) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        var ret;
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        root = root || Y.config.doc;
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        if (tag && root.getElementsByTagName) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            ret = root.getElementsByTagName(tag)[0];
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        }
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        return ret || null;
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    },
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    /**
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * Returns the text content of the HTMLElement.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @method getText
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {HTMLElement} element The html element.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @return {String} The text content of the element (includes text of any descending elements).
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     */
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    getText: (documentElement.textContent !== undefined) ?
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        function(element) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            var ret = '';
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            if (element) {
a62d691262d0b1a55b3fc79eba377ac7bd1c0629jeff.schenk                ret = element.textContent;
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            }
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            return ret || '';
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        } : function(element) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            var ret = '';
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            if (element) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major                ret = element.innerText || element.nodeValue; // might be a textNode
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            }
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            return ret || '';
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        },
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    /**
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * Sets the text content of the HTMLElement.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @method setText
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {HTMLElement} element The html element.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {String} content The content to add.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     */
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    setText: (documentElement.textContent !== undefined) ?
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        function(element, content) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            if (element) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major                element.textContent = content;
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            }
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        } : function(element, content) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            if ('innerText' in element) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major                element.innerText = content;
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            } else if ('nodeValue' in element) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major                element.nodeValue = content;
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            }
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        },
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    /*
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * Finds the previous sibling of the element.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @method previous
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @deprecated Use elementByAxis
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {HTMLElement} element The html element.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {Function} fn optional An optional boolean test to apply.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * The optional function is passed the current DOM node being tested as its only argument.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * If no function is given, the first sibling is returned.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {Boolean} all optional Whether all node types should be scanned, or just element nodes.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @return {HTMLElement | null} The matching DOM node or null if none found.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     */
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    previous: function(element, fn, all) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        return Y_DOM.elementByAxis(element, PREVIOUS_SIBLING, fn, all);
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    },
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    /*
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * Finds the next sibling of the element.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @method next
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @deprecated Use elementByAxis
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {HTMLElement} element The html element.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {Function} fn optional An optional boolean test to apply.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * The optional function is passed the current DOM node being tested as its only argument.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * If no function is given, the first sibling is returned.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {Boolean} all optional Whether all node types should be scanned, or just element nodes.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @return {HTMLElement | null} The matching DOM node or null if none found.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     */
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    next: function(element, fn, all) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        return Y_DOM.elementByAxis(element, NEXT_SIBLING, fn, all);
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    },
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    /*
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * Finds the ancestor of the element.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @method ancestor
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {HTMLElement} element The html element.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {Function} fn optional An optional boolean test to apply.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * The optional function is passed the current DOM node being tested as its only argument.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * If no function is given, the parentNode is returned.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {Boolean} testSelf optional Whether or not to include the element in the scan
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @return {HTMLElement | null} The matching DOM node or null if none found.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     */
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    ancestor: function(element, fn, testSelf) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        var ret = null;
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        if (testSelf) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            ret = (!fn || fn(element)) ? element : null;
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        }
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        return ret || Y_DOM.elementByAxis(element, PARENT_NODE, fn, null);
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    },
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    /*
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * Finds the ancestors of the element.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @method ancestors
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {HTMLElement} element The html element.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @param {Function} fn optional An optional boolean test to apply.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * The optional function is passed the current DOM node being tested as its only argument.
87e1cbcd02820f55e1816ee4efe9e9127be22a11James Phillpotts     * If no function is given, all ancestors are returned.
87e1cbcd02820f55e1816ee4efe9e9127be22a11James Phillpotts     * @param {Boolean} testSelf optional Whether or not to include the element in the scan
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     * @return {Array} An array containing all matching DOM nodes.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     */
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    ancestors: function(element, fn, testSelf) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        var ancestor = Y_DOM.ancestor.apply(Y_DOM, arguments),
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            ret = (ancestor) ? [ancestor] : [];
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        while ((ancestor = Y_DOM.ancestor(ancestor, fn))) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            if (ancestor) {
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major                ret.unshift(ancestor);
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major            }
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        }
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major        return ret;
8b6198b1170e3128c5df83267597f0058d07c70dJames Phillpotts    },
8b6198b1170e3128c5df83267597f0058d07c70dJames Phillpotts
8b6198b1170e3128c5df83267597f0058d07c70dJames Phillpotts    /**
8b6198b1170e3128c5df83267597f0058d07c70dJames Phillpotts     * Searches the element by the given axis for the first matching element.
8b6198b1170e3128c5df83267597f0058d07c70dJames Phillpotts     * @method elementByAxis
8b6198b1170e3128c5df83267597f0058d07c70dJames Phillpotts     * @param {HTMLElement} element The html element.
8b6198b1170e3128c5df83267597f0058d07c70dJames Phillpotts     * @param {String} axis The axis to search (parentNode, nextSibling, previousSibling).
8b6198b1170e3128c5df83267597f0058d07c70dJames Phillpotts     * @param {Function} fn optional An optional boolean test to apply.
921c9e8e47accb592cc0dcda4f6973aabc1935ceNeil Madden     * @param {Boolean} all optional Whether all node types should be returned, or just element nodes.
921c9e8e47accb592cc0dcda4f6973aabc1935ceNeil Madden     * The optional function is passed the current HTMLElement being tested as its only argument.
921c9e8e47accb592cc0dcda4f6973aabc1935ceNeil Madden     * If no function is given, the first element is returned.
921c9e8e47accb592cc0dcda4f6973aabc1935ceNeil Madden     * @return {HTMLElement | null} The matching element or null if none found.
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major     */
e8721886dbfd32e88cc7077cbee4b6bb1b44b443Peter Major    elementByAxis: function(element, axis, fn, all) {
        while (element && (element = element[axis])) { // NOTE: assignment
                if ( (all || element[TAG_NAME]) && (!fn || fn(element)) ) {
                    return element;
                }
        }
        return null;
    },

    /**
     * Determines whether or not one HTMLElement is or contains another HTMLElement.
     * @method contains
     * @param {HTMLElement} element The containing html element.
     * @param {HTMLElement} needle The html element that may be contained.
     * @return {Boolean} Whether or not the element is or contains the needle.
     */
    contains: function(element, needle) {
        var ret = false;

        if ( !needle || !element || !needle[NODE_TYPE] || !element[NODE_TYPE]) {
            ret = false;
        } else if (element[CONTAINS])  {
            if (Y.UA.opera || needle[NODE_TYPE] === 1) { // IE & SAF contains fail if needle not an ELEMENT_NODE
                ret = element[CONTAINS](needle);
            } else {
                ret = Y_DOM._bruteContains(element, needle);
            }
        } else if (element[COMPARE_DOCUMENT_POSITION]) { // gecko
            if (element === needle || !!(element[COMPARE_DOCUMENT_POSITION](needle) & 16)) {
                ret = true;
            }
        }

        return ret;
    },

    /**
     * Determines whether or not the HTMLElement is part of the document.
     * @method inDoc
     * @param {HTMLElement} element The containing html element.
     * @param {HTMLElement} doc optional The document to check.
     * @return {Boolean} Whether or not the element is attached to the document.
     */
    inDoc: function(element, doc) {
        var ret = false,
            rootNode;

        if (element && element.nodeType) {
            (doc) || (doc = element[OWNER_DOCUMENT]);

            rootNode = doc[DOCUMENT_ELEMENT];

            // contains only works with HTML_ELEMENT
            if (rootNode && rootNode.contains && element.tagName) {
                ret = rootNode.contains(element);
            } else {
                ret = Y_DOM.contains(rootNode, element);
            }
        }

        return ret;

    },

   allById: function(id, root) {
        root = root || Y.config.doc;
        var nodes = [],
            ret = [],
            i,
            node;

        if (root.querySelectorAll) {
            ret = root.querySelectorAll('[id="' + id + '"]');
        } else if (root.all) {
            nodes = root.all(id);
            if (nodes && nodes.nodeType) { // root.all may return one or many
                nodes = [nodes];
            }

            if (nodes && nodes.length) {
                for (i = 0; node = nodes[i++];) { // check for a match
                    if (node.attributes && node.attributes.id
                            && node.attributes.id.value === id) { // avoid false positive for node.name & form.id
                        ret.push(node);
                    }
                }
            }
        } else {
            ret = [Y_DOM._getDoc(root).getElementById(id)];
        }

        return ret;
   },

    /**
     * Creates a new dom node using the provided markup string.
     * @method create
     * @param {String} html The markup used to create the element
     * @param {HTMLDocument} doc An optional document context
     * @return {HTMLElement|DocumentFragment} returns a single HTMLElement
     * when creating one node, and a documentFragment when creating
     * multiple nodes.
     */
    create: function(html, doc) {
        if (typeof html === 'string') {
            html = Y.Lang.trim(html); // match IE which trims whitespace from innerHTML

        }

        doc = doc || Y.config.doc;
        var m = re_tag.exec(html),
            create = Y_DOM._create,
            custom = Y_DOM.creators,
            ret = null,
            tag, nodes;

        if (html != undefined) { // not undefined or null
            if (m && custom[m[1]]) {
                if (typeof custom[m[1]] === 'function') {
                    create = custom[m[1]];
                } else {
                    tag = custom[m[1]];
                }
            }

            nodes = create(html, doc, tag).childNodes;

            if (nodes.length === 1) { // return single node, breaking parentNode ref from "fragment"
                ret = nodes[0].parentNode.removeChild(nodes[0]);
            } else if (nodes[0] && nodes[0].className === 'yui3-big-dummy') { // using dummy node to preserve some attributes (e.g. OPTION not selected)
                if (nodes.length === 2) {
                    ret = nodes[0].nextSibling;
                } else {
                    nodes[0].parentNode.removeChild(nodes[0]);
                     ret = Y_DOM._nl2frag(nodes, doc);
                }
            } else { // return multiple nodes as a fragment
                 ret = Y_DOM._nl2frag(nodes, doc);
            }
        }

        return ret;
    },

    _nl2frag: function(nodes, doc) {
        var ret = null,
            i, len;

        if (nodes && (nodes.push || nodes.item) && nodes[0]) {
            doc = doc || nodes[0].ownerDocument;
            ret = doc.createDocumentFragment();

            if (nodes.item) { // convert live list to static array
                nodes = Y.Array(nodes, 0, true);
            }

            for (i = 0, len = nodes.length; i < len; i++) {
                ret.appendChild(nodes[i]);
            }
        } // else inline with log for minification
        else { Y.log('unable to convert ' + nodes + ' to fragment', 'warn', 'dom'); }
        return ret;
    },


    CUSTOM_ATTRIBUTES: (!documentElement.hasAttribute) ? { // IE < 8
        'for': 'htmlFor',
        'class': 'className'
    } : { // w3c
        'htmlFor': 'for',
        'className': 'class'
    },

    /**
     * Provides a normalized attribute interface.
     * @method setAttibute
     * @param {String | HTMLElement} el The target element for the attribute.
     * @param {String} attr The attribute to set.
     * @param {String} val The value of the attribute.
     */
    setAttribute: function(el, attr, val, ieAttr) {
        if (el && attr && el.setAttribute) {
            attr = Y_DOM.CUSTOM_ATTRIBUTES[attr] || attr;
            el.setAttribute(attr, val, ieAttr);
        }
        else { Y.log('bad input to setAttribute', 'warn', 'dom'); }
    },


    /**
     * Provides a normalized attribute interface.
     * @method getAttibute
     * @param {String | HTMLElement} el The target element for the attribute.
     * @param {String} attr The attribute to get.
     * @return {String} The current value of the attribute.
     */
    getAttribute: function(el, attr, ieAttr) {
        ieAttr = (ieAttr !== undefined) ? ieAttr : 2;
        var ret = '';
        if (el && attr && el.getAttribute) {
            attr = Y_DOM.CUSTOM_ATTRIBUTES[attr] || attr;
            ret = el.getAttribute(attr, ieAttr);

            if (ret === null) {
                ret = ''; // per DOM spec
            }
        }
        else { Y.log('bad input to getAttribute', 'warn', 'dom'); }
        return ret;
    },

    isWindow: function(obj) {
        return !!(obj && obj.alert && obj.document);
    },

    _fragClones: {},

    _create: function(html, doc, tag) {
        tag = tag || 'div';

        var frag = Y_DOM._fragClones[tag];
        if (frag) {
            frag = frag.cloneNode(false);
        } else {
            frag = Y_DOM._fragClones[tag] = doc.createElement(tag);
        }
        frag.innerHTML = html;
        return frag;
    },

    _removeChildNodes: function(node) {
        while (node.firstChild) {
            node.removeChild(node.firstChild);
        }
    },

    /**
     * Inserts content in a node at the given location
     * @method addHTML
     * @param {HTMLElement} node The node to insert into
     * @param {String | HTMLElement | Array | HTMLCollection} content The content to be inserted
     * @param {String | HTMLElement} where Where to insert the content
     * If no "where" is given, content is appended to the node
     * Possible values for "where"
     * <dl>
     * <dt>HTMLElement</dt>
     * <dd>The element to insert before</dd>
     * <dt>"replace"</dt>
     * <dd>Replaces the existing HTML</dd>
     * <dt>"before"</dt>
     * <dd>Inserts before the existing HTML</dd>
     * <dt>"before"</dt>
     * <dd>Inserts content before the node</dd>
     * <dt>"after"</dt>
     * <dd>Inserts content after the node</dd>
     * </dl>
     */
    addHTML: function(node, content, where) {
        var nodeParent = node.parentNode,
            i = 0,
            item,
            ret = content,
            newNode;


        if (content != undefined) { // not null or undefined (maybe 0)
            if (content.nodeType) { // DOM node, just add it
                newNode = content;
            } else if (typeof content == 'string' || typeof content == 'number') {
                ret = newNode = Y_DOM.create(content);
            } else if (content[0] && content[0].nodeType) { // array or collection
                newNode = Y.config.doc.createDocumentFragment();
                while ((item = content[i++])) {
                    newNode.appendChild(item); // append to fragment for insertion
                }
            }
        }

        if (where) {
            if (where.nodeType) { // insert regardless of relationship to node
                where.parentNode.insertBefore(newNode, where);
            } else {
                switch (where) {
                    case 'replace':
                        while (node.firstChild) {
                            node.removeChild(node.firstChild);
                        }
                        if (newNode) { // allow empty content to clear node
                            node.appendChild(newNode);
                        }
                        break;
                    case 'before':
                        nodeParent.insertBefore(newNode, node);
                        break;
                    case 'after':
                        if (node.nextSibling) { // IE errors if refNode is null
                            nodeParent.insertBefore(newNode, node.nextSibling);
                        } else {
                            nodeParent.appendChild(newNode);
                        }
                        break;
                    default:
                        node.appendChild(newNode);
                }
            }
        } else if (newNode) {
            node.appendChild(newNode);
        }

        return ret;
    },

    VALUE_SETTERS: {},

    VALUE_GETTERS: {},

    getValue: function(node) {
        var ret = '', // TODO: return null?
            getter;

        if (node && node[TAG_NAME]) {
            getter = Y_DOM.VALUE_GETTERS[node[TAG_NAME].toLowerCase()];

            if (getter) {
                ret = getter(node);
            } else {
                ret = node.value;
            }
        }

        // workaround for IE8 JSON stringify bug
        // which converts empty string values to null
        if (ret === EMPTY_STRING) {
            ret = EMPTY_STRING; // for real
        }

        return (typeof ret === 'string') ? ret : '';
    },

    setValue: function(node, val) {
        var setter;

        if (node && node[TAG_NAME]) {
            setter = Y_DOM.VALUE_SETTERS[node[TAG_NAME].toLowerCase()];

            if (setter) {
                setter(node, val);
            } else {
                node.value = val;
            }
        }
    },

    siblings: function(node, fn) {
        var nodes = [],
            sibling = node;

        while ((sibling = sibling[PREVIOUS_SIBLING])) {
            if (sibling[TAG_NAME] && (!fn || fn(sibling))) {
                nodes.unshift(sibling);
            }
        }

        sibling = node;
        while ((sibling = sibling[NEXT_SIBLING])) {
            if (sibling[TAG_NAME] && (!fn || fn(sibling))) {
                nodes.push(sibling);
            }
        }

        return nodes;
    },

    /**
     * Brute force version of contains.
     * Used for browsers without contains support for non-HTMLElement Nodes (textNodes, etc).
     * @method _bruteContains
     * @private
     * @param {HTMLElement} element The containing html element.
     * @param {HTMLElement} needle The html element that may be contained.
     * @return {Boolean} Whether or not the element is or contains the needle.
     */
    _bruteContains: function(element, needle) {
        while (needle) {
            if (element === needle) {
                return true;
            }
            needle = needle.parentNode;
        }
        return false;
    },

// TODO: move to Lang?
    /**
     * Memoizes dynamic regular expressions to boost runtime performance.
     * @method _getRegExp
     * @private
     * @param {String} str The string to convert to a regular expression.
     * @param {String} flags optional An optinal string of flags.
     * @return {RegExp} An instance of RegExp
     */
    _getRegExp: function(str, flags) {
        flags = flags || '';
        Y_DOM._regexCache = Y_DOM._regexCache || {};
        if (!Y_DOM._regexCache[str + flags]) {
            Y_DOM._regexCache[str + flags] = new RegExp(str, flags);
        }
        return Y_DOM._regexCache[str + flags];
    },

// TODO: make getDoc/Win true privates?
    /**
     * returns the appropriate document.
     * @method _getDoc
     * @private
     * @param {HTMLElement} element optional Target element.
     * @return {Object} The document for the given element or the default document.
     */
    _getDoc: function(element) {
        var doc = Y.config.doc;
        if (element) {
            doc = (element[NODE_TYPE] === 9) ? element : // element === document
                element[OWNER_DOCUMENT] || // element === DOM node
                element.document || // element === window
                Y.config.doc; // default
        }

        return doc;
    },

    /**
     * returns the appropriate window.
     * @method _getWin
     * @private
     * @param {HTMLElement} element optional Target element.
     * @return {Object} The window for the given element or the default window.
     */
    _getWin: function(element) {
        var doc = Y_DOM._getDoc(element);
        return doc[DEFAULT_VIEW] || doc[PARENT_WINDOW] || Y.config.win;
    },

    _batch: function(nodes, fn, arg1, arg2, arg3, etc) {
        fn = (typeof fn === 'string') ? Y_DOM[fn] : fn;
        var result,
            args = Array.prototype.slice.call(arguments, 2),
            i = 0,
            node,
            ret;

        if (fn && nodes) {
            while ((node = nodes[i++])) {
                result = result = fn.call(Y_DOM, node, arg1, arg2, arg3, etc);
                if (typeof result !== 'undefined') {
                    (ret) || (ret = []);
                    ret.push(result);
                }
            }
        }

        return (typeof ret !== 'undefined') ? ret : nodes;
    },

    wrap: function(node, html) {
        var parent = Y.DOM.create(html),
            nodes = parent.getElementsByTagName('*');

        if (nodes.length) {
            parent = nodes[nodes.length - 1];
        }

        if (node.parentNode) {
            node.parentNode.replaceChild(parent, node);
        }
        parent.appendChild(node);
    },

    unwrap: function(node) {
        var parent = node.parentNode,
            lastChild = parent.lastChild,
            node = parent.firstChild,
            next = node,
            grandparent;

        if (parent) {
            grandparent = parent.parentNode;
            if (grandparent) {
                while (node !== lastChild) {
                    next = node.nextSibling;
                    grandparent.insertBefore(node, parent);
                    node = next;
                }
                grandparent.replaceChild(lastChild, parent);
            } else {
                parent.removeChild(node);
            }
        }
    },

    creators: {}
};


(function(Y) {
    var creators = Y_DOM.creators,
        create = Y_DOM.create,
        re_tbody = /(?:\/(?:thead|tfoot|tbody|caption|col|colgroup)>)+\s*<tbody/,

        TABLE_OPEN = '<table>',
        TABLE_CLOSE = '</table>';

    if (Y.UA.ie) {
        Y.mix(creators, {
        // TODO: thead/tfoot with nested tbody
            // IE adds TBODY when creating TABLE elements (which may share this impl)
            tbody: function(html, doc) {
                var frag = create(TABLE_OPEN + html + TABLE_CLOSE, doc),
                    tb = frag.children.tags('tbody')[0];

                if (frag.children.length > 1 && tb && !re_tbody.test(html)) {
                    tb[PARENT_NODE].removeChild(tb); // strip extraneous tbody
                }
                return frag;
            },

            script: function(html, doc) {
                var frag = doc.createElement('div');

                frag.innerHTML = '-' + html;
                frag.removeChild(frag[FIRST_CHILD]);
                return frag;
            }

        }, true);

        Y.mix(Y_DOM.VALUE_GETTERS, {
            button: function(node) {
                return (node.attributes && node.attributes.value) ? node.attributes.value.value : '';
            }
        });

        Y.mix(Y_DOM.VALUE_SETTERS, {
            // IE: node.value changes the button text, which should be handled via innerHTML
            button: function(node, val) {
                var attr = node.attributes.value;
                if (!attr) {
                    attr = node[OWNER_DOCUMENT].createAttribute('value');
                    node.setAttributeNode(attr);
                }

                attr.value = val;
            },

            select: function(node, val) {
                for (var i = 0, options = node.getElementsByTagName('option'), option;
                        option = options[i++];) {
                    if (Y_DOM.getValue(option) === val) {
                        Y_DOM.setAttribute(option, 'selected', true);
                        break;
                    }
                }
            }
        });

        Y_DOM.creators.col = Y_DOM.creators.link = Y_DOM.creators.style = Y_DOM.creators.script;
    }

    if (Y.UA.gecko || Y.UA.ie) {
        Y.mix(creators, {
            option: function(html, doc) {
                return create('<select><option class="yui3-big-dummy" selected></option>' + html + '</select>', doc);
            },

            tr: function(html, doc) {
                return create('<tbody>' + html + '</tbody>', doc);
            },

            td: function(html, doc) {
                return create('<tr>' + html + '</tr>', doc);
            },

            tbody: function(html, doc) {
                return create(TABLE_OPEN + html + TABLE_CLOSE, doc);
            }
        });

        Y.mix(creators, {
            legend: 'fieldset',
            th: creators.td,
            thead: creators.tbody,
            tfoot: creators.tbody,
            caption: creators.tbody,
            colgroup: creators.tbody,
            col: creators.tbody,
            optgroup: creators.option
        });
    }

    Y.mix(Y_DOM.VALUE_GETTERS, {
        option: function(node) {
            var attrs = node.attributes;
            return (attrs.value && attrs.value.specified) ? node.value : node.text;
        },

        select: function(node) {
            var val = node.value,
                options = node.options;

            if (options && options.length && val === '') {
                // TODO: implement multipe select
                if (node.multiple) {
                    Y.log('multiple select normalization not implemented', 'warn', 'DOM');
                } else {
                    val = Y_DOM.getValue(options[node.selectedIndex]);
                }
            }

            return val;
        }
    });
})(Y);

Y.DOM = Y_DOM;
})(Y);
var addClass, hasClass, removeClass;

Y.mix(Y.DOM, {
    /**
     * Determines whether a DOM element has the given className.
     * @method hasClass
     * @for DOM
     * @param {HTMLElement} element The DOM element.
     * @param {String} className the class name to search for
     * @return {Boolean} Whether or not the element has the given class.
     */
    hasClass: function(node, className) {
        var re = Y.DOM._getRegExp('(?:^|\\s+)' + className + '(?:\\s+|$)');
        return re.test(node.className);
    },

    /**
     * Adds a class name to a given DOM element.
     * @method addClass
     * @for DOM
     * @param {HTMLElement} element The DOM element.
     * @param {String} className the class name to add to the class attribute
     */
    addClass: function(node, className) {
        if (!Y.DOM.hasClass(node, className)) { // skip if already present
            node.className = Y.Lang.trim([node.className, className].join(' '));
        }
    },

    /**
     * Removes a class name from a given element.
     * @method removeClass
     * @for DOM
     * @param {HTMLElement} element The DOM element.
     * @param {String} className the class name to remove from the class attribute
     */
    removeClass: function(node, className) {
        if (className && hasClass(node, className)) {
            node.className = Y.Lang.trim(node.className.replace(Y.DOM._getRegExp('(?:^|\\s+)' +
                            className + '(?:\\s+|$)'), ' '));

            if ( hasClass(node, className) ) { // in case of multiple adjacent
                removeClass(node, className);
            }
        }
    },

    /**
     * Replace a class with another class for a given element.
     * If no oldClassName is present, the newClassName is simply added.
     * @method replaceClass
     * @for DOM
     * @param {HTMLElement} element The DOM element
     * @param {String} oldClassName the class name to be replaced
     * @param {String} newClassName the class name that will be replacing the old class name
     */
    replaceClass: function(node, oldC, newC) {
        //Y.log('replaceClass replacing ' + oldC + ' with ' + newC, 'info', 'Node');
        removeClass(node, oldC); // remove first in case oldC === newC
        addClass(node, newC);
    },

    /**
     * If the className exists on the node it is removed, if it doesn't exist it is added.
     * @method toggleClass
     * @for DOM
     * @param {HTMLElement} element The DOM element
     * @param {String} className the class name to be toggled
     * @param {Boolean} addClass optional boolean to indicate whether class
     * should be added or removed regardless of current state
     */
    toggleClass: function(node, className, force) {
        var add = (force !== undefined) ? force :
                !(hasClass(node, className));

        if (add) {
            addClass(node, className);
        } else {
            removeClass(node, className);
        }
    }
});

hasClass = Y.DOM.hasClass;
removeClass = Y.DOM.removeClass;
addClass = Y.DOM.addClass;

Y.mix(Y.DOM, {
    /**
     * Sets the width of the element to the given size, regardless
     * of box model, border, padding, etc.
     * @method setWidth
     * @param {HTMLElement} element The DOM element.
     * @param {String|Int} size The pixel height to size to
     */

    setWidth: function(node, size) {
        Y.DOM._setSize(node, 'width', size);
    },

    /**
     * Sets the height of the element to the given size, regardless
     * of box model, border, padding, etc.
     * @method setHeight
     * @param {HTMLElement} element The DOM element.
     * @param {String|Int} size The pixel height to size to
     */

    setHeight: function(node, size) {
        Y.DOM._setSize(node, 'height', size);
    },

    _setSize: function(node, prop, val) {
        val = (val > 0) ? val : 0;
        var size = 0;

        node.style[prop] = val + 'px';
        size = (prop === 'height') ? node.offsetHeight : node.offsetWidth;

        if (size > val) {
            val = val - (size - val);

            if (val < 0) {
                val = 0;
            }

            node.style[prop] = val + 'px';
        }
    }
});


}, '@VERSION@' ,{requires:['oop']});