//>>built define("dojo/NodeList-traverse", ["./query", "./_base/lang", "./_base/array"], function(dquery, lang, array) { // module: // dojo/NodeList-traverse // summary: // TODOC var NodeList = dquery.NodeList; /*===== dojo["NodeList-traverse"] = { // summary: Adds a chainable methods to dojo.query() / Nodelist instances for traversing the DOM }; // doc alias helpers: NodeList = dojo.NodeList; =====*/ lang.extend(NodeList, { _buildArrayFromCallback: function(/*Function*/callback){ // summary: // builds a new array of possibly differing size based on the input list. // Since the returned array is likely of different size than the input array, // the array's map function cannot be used. var ary = []; for(var i = 0; i < this.length; i++){ var items = callback.call(this[i], this[i], ary); if(items){ ary = ary.concat(items); } } return ary; //Array }, _getUniqueAsNodeList: function(/*Array*/ nodes){ // summary: // given a list of nodes, make sure only unique // elements are returned as our NodeList object. // Does not call _stash(). var ary = []; //Using for loop for better speed. for(var i = 0, node; node = nodes[i]; i++){ //Should be a faster way to do this. dojo.query has a private //_zip function that may be inspirational, but there are pathways //in query that force nozip? if(node.nodeType == 1 && array.indexOf(ary, node) == -1){ ary.push(node); } } return this._wrap(ary, null, this._NodeListCtor); //dojo.NodeList }, _getUniqueNodeListWithParent: function(/*Array*/ nodes, /*String*/ query){ // summary: // gets unique element nodes, filters them further // with an optional query and then calls _stash to track parent NodeList. var ary = this._getUniqueAsNodeList(nodes); ary = (query ? dquery._filterResult(ary, query) : ary); return ary._stash(this); //dojo.NodeList }, _getRelatedUniqueNodes: function(/*String?*/ query, /*Function*/ callback){ // summary: // cycles over all the nodes and calls a callback // to collect nodes for a possible inclusion in a result. // The callback will get two args: callback(node, ary), // where ary is the array being used to collect the nodes. return this._getUniqueNodeListWithParent(this._buildArrayFromCallback(callback), query); //dojo.NodeList }, children: function(/*String?*/ query){ // summary: // Returns all immediate child elements for nodes in this dojo.NodeList. // Optionally takes a query to filter the child elements. // description: // .end() can be used on the returned dojo.NodeList to get back to the // original dojo.NodeList. // query: // a CSS selector. // returns: // dojo.NodeList, all immediate child elements for the nodes in this dojo.NodeList. // example: // assume a DOM created by this markup: // |
// |
Red One
// | Some Text // |
Blue One
// |
Red Two
// |
Blue Two
// |
// Running this code: // | dojo.query(".container").children(); // returns the four divs that are children of the container div. // Running this code: // | dojo.query(".container").children(".red"); // returns the two divs that have the class "red". return this._getRelatedUniqueNodes(query, function(node, ary){ return lang._toArray(node.childNodes); }); //dojo.NodeList }, closest: function(/*String*/ query, /*String|DOMNode?*/ root){ // summary: // Returns closest parent that matches query, including current node in this // dojo.NodeList if it matches the query. // description: // .end() can be used on the returned dojo.NodeList to get back to the // original dojo.NodeList. // query: // a CSS selector. // root: // If specified, query is relative to "root" rather than document body. // returns: // dojo.NodeList, the closest parent that matches the query, including the current // node in this dojo.NodeList if it matches the query. // example: // assume a DOM created by this markup: // |
// |
Red One
// | Some Text // |
Blue One
// |
Red Two
// |
Blue Two
// |
// Running this code: // | dojo.query(".red").closest(".container"); // returns the div with class "container". return this._getRelatedUniqueNodes(null, function(node, ary){ do{ if(dquery._filterResult([node], query, root).length){ return node; } }while(node != root && (node = node.parentNode) && node.nodeType == 1); return null; //To make rhino strict checking happy. }); //dojo.NodeList }, parent: function(/*String?*/ query){ // summary: // Returns immediate parent elements for nodes in this dojo.NodeList. // Optionally takes a query to filter the parent elements. // description: // .end() can be used on the returned dojo.NodeList to get back to the // original dojo.NodeList. // query: // a CSS selector. // returns: // dojo.NodeList, immediate parent elements for nodes in this dojo.NodeList. // example: // assume a DOM created by this markup: // |
// |
Red One
// |
Blue One
// |
Red Two
// |
Blue Two
// |
// Running this code: // | dojo.query(".text").parent(); // returns the two divs with class "blue". // Running this code: // | dojo.query(".text").parent(".first"); // returns the one div with class "blue" and "first". return this._getRelatedUniqueNodes(query, function(node, ary){ return node.parentNode; }); //dojo.NodeList }, parents: function(/*String?*/ query){ // summary: // Returns all parent elements for nodes in this dojo.NodeList. // Optionally takes a query to filter the child elements. // description: // .end() can be used on the returned dojo.NodeList to get back to the // original dojo.NodeList. // query: // a CSS selector. // returns: // dojo.NodeList, all parent elements for nodes in this dojo.NodeList. // example: // assume a DOM created by this markup: // |
// |
Red One
// |
Blue One
// |
Red Two
// |
Blue Two
// |
// Running this code: // | dojo.query(".text").parents(); // returns the two divs with class "blue", the div with class "container", // | the body element and the html element. // Running this code: // | dojo.query(".text").parents(".container"); // returns the one div with class "container". return this._getRelatedUniqueNodes(query, function(node, ary){ var pary = []; while(node.parentNode){ node = node.parentNode; pary.push(node); } return pary; }); //dojo.NodeList }, siblings: function(/*String?*/ query){ // summary: // Returns all sibling elements for nodes in this dojo.NodeList. // Optionally takes a query to filter the sibling elements. // description: // .end() can be used on the returned dojo.NodeList to get back to the // original dojo.NodeList. // query: // a CSS selector. // returns: // dojo.NodeList, all sibling elements for nodes in this dojo.NodeList. // example: // assume a DOM created by this markup: // |
// |
Red One
// | Some Text // |
Blue One
// |
Red Two
// |
Blue Two
// |
// Running this code: // | dojo.query(".first").siblings(); // returns the two divs with class "red" and the other div // | with class "blue" that does not have "first". // Running this code: // | dojo.query(".first").siblings(".red"); // returns the two div with class "red". return this._getRelatedUniqueNodes(query, function(node, ary){ var pary = []; var nodes = (node.parentNode && node.parentNode.childNodes); for(var i = 0; i < nodes.length; i++){ if(nodes[i] != node){ pary.push(nodes[i]); } } return pary; }); //dojo.NodeList }, next: function(/*String?*/ query){ // summary: // Returns the next element for nodes in this dojo.NodeList. // Optionally takes a query to filter the next elements. // description: // .end() can be used on the returned dojo.NodeList to get back to the // original dojo.NodeList. // query: // a CSS selector. // returns: // dojo.NodeList, the next element for nodes in this dojo.NodeList. // example: // assume a DOM created by this markup: // |
// |
Red One
// | Some Text // |
Blue One
// |
Red Two
// |
Blue Two
// |
// Running this code: // | dojo.query(".first").next(); // returns the div with class "red" and has innerHTML of "Red Two". // Running this code: // | dojo.query(".last").next(".red"); // does not return any elements. return this._getRelatedUniqueNodes(query, function(node, ary){ var next = node.nextSibling; while(next && next.nodeType != 1){ next = next.nextSibling; } return next; }); //dojo.NodeList }, nextAll: function(/*String?*/ query){ // summary: // Returns all sibling elements that come after the nodes in this dojo.NodeList. // Optionally takes a query to filter the sibling elements. // description: // .end() can be used on the returned dojo.NodeList to get back to the // original dojo.NodeList. // query: // a CSS selector. // returns: // dojo.NodeList, all sibling elements that come after the nodes in this dojo.NodeList. // example: // assume a DOM created by this markup: // |
// |
Red One
// | Some Text // |
Blue One
// | // | // |
// Running this code: // | dojo.query(".first").nextAll(); // returns the two divs with class of "next". // Running this code: // | dojo.query(".first").nextAll(".red"); // returns the one div with class "red" and innerHTML "Red Two". return this._getRelatedUniqueNodes(query, function(node, ary){ var pary = []; var next = node; while((next = next.nextSibling)){ if(next.nodeType == 1){ pary.push(next); } } return pary; }); //dojo.NodeList }, prev: function(/*String?*/ query){ // summary: // Returns the previous element for nodes in this dojo.NodeList. // Optionally takes a query to filter the previous elements. // description: // .end() can be used on the returned dojo.NodeList to get back to the // original dojo.NodeList. // query: // a CSS selector. // returns: // dojo.NodeList, the previous element for nodes in this dojo.NodeList. // example: // assume a DOM created by this markup: // |
// |
Red One
// | Some Text // |
Blue One
// |
Red Two
// |
Blue Two
// |
// Running this code: // | dojo.query(".first").prev(); // returns the div with class "red" and has innerHTML of "Red One". // Running this code: // | dojo.query(".first").prev(".blue"); // does not return any elements. return this._getRelatedUniqueNodes(query, function(node, ary){ var prev = node.previousSibling; while(prev && prev.nodeType != 1){ prev = prev.previousSibling; } return prev; }); //dojo.NodeList }, prevAll: function(/*String?*/ query){ // summary: // Returns all sibling elements that come before the nodes in this dojo.NodeList. // Optionally takes a query to filter the sibling elements. // description: // The returned nodes will be in reverse DOM order -- the first node in the list will // be the node closest to the original node/NodeList. // .end() can be used on the returned dojo.NodeList to get back to the // original dojo.NodeList. // query: // a CSS selector. // returns: // dojo.NodeList, all sibling elements that come before the nodes in this dojo.NodeList. // example: // assume a DOM created by this markup: // |
// | // | Some Text // | // |
Red Two
// |
Blue Two
// |
// Running this code: // | dojo.query(".second").prevAll(); // returns the two divs with class of "prev". // Running this code: // | dojo.query(".first").prevAll(".red"); // returns the one div with class "red prev" and innerHTML "Red One". return this._getRelatedUniqueNodes(query, function(node, ary){ var pary = []; var prev = node; while((prev = prev.previousSibling)){ if(prev.nodeType == 1){ pary.push(prev); } } return pary; }); //dojo.NodeList }, andSelf: function(){ // summary: // Adds the nodes from the previous dojo.NodeList to the current dojo.NodeList. // description: // .end() can be used on the returned dojo.NodeList to get back to the // original dojo.NodeList. // returns: // dojo.NodeList // example: // assume a DOM created by this markup: // |
// | // | Some Text // | // |
Red Two
// |
Blue Two
// |
// Running this code: // | dojo.query(".second").prevAll().andSelf(); // returns the two divs with class of "prev", as well as the div with class "second". return this.concat(this._parent); //dojo.NodeList }, //Alternate methods for the :first/:last/:even/:odd pseudos. first: function(){ // summary: // Returns the first node in this dojo.NodeList as a dojo.NodeList. // description: // .end() can be used on the returned dojo.NodeList to get back to the // original dojo.NodeList. // returns: // dojo.NodeList, with the first node in this dojo.NodeList // example: // assume a DOM created by this markup: // |
// |
Red One
// |
Blue One
// |
Red Two
// |
Blue Two
// |
// Running this code: // | dojo.query(".blue").first(); // returns the div with class "blue" and "first". return this._wrap(((this[0] && [this[0]]) || []), this); //dojo.NodeList }, last: function(){ // summary: // Returns the last node in this dojo.NodeList as a dojo.NodeList. // description: // .end() can be used on the returned dojo.NodeList to get back to the // original dojo.NodeList. // returns: // dojo.NodeList, with the last node in this dojo.NodeList // example: // assume a DOM created by this markup: // |
// |
Red One
// |
Blue One
// |
Red Two
// |
Blue Two
// |
// Running this code: // | dojo.query(".blue").last(); // returns the last div with class "blue", return this._wrap((this.length ? [this[this.length - 1]] : []), this); //dojo.NodeList }, even: function(){ // summary: // Returns the even nodes in this dojo.NodeList as a dojo.NodeList. // description: // .end() can be used on the returned dojo.NodeList to get back to the // original dojo.NodeList. // returns: // dojo.NodeList, with the even nodes in this dojo.NodeList // example: // assume a DOM created by this markup: // |
// |
Red One
// |
Blue One
// |
Red Two
// |
Blue Two
// |
// Running this code: // | dojo.query(".interior").even(); // returns the two divs with class "blue" return this.filter(function(item, i){ return i % 2 != 0; }); //dojo.NodeList }, odd: function(){ // summary: // Returns the odd nodes in this dojo.NodeList as a dojo.NodeList. // description: // .end() can be used on the returned dojo.NodeList to get back to the // original dojo.NodeList. // returns: // dojo.NodeList, with the odd nodes in this dojo.NodeList // example: // assume a DOM created by this markup: // |
// |
Red One
// |
Blue One
// |
Red Two
// |
Blue Two
// |
// Running this code: // | dojo.query(".interior").odd(); // returns the two divs with class "red" return this.filter(function(item, i){ return i % 2 == 0; }); //dojo.NodeList } }); return NodeList; });