diff options
Diffstat (limited to 'includes/js/dojo/_base/NodeList.js')
| -rw-r--r-- | includes/js/dojo/_base/NodeList.js | 532 |
1 files changed, 0 insertions, 532 deletions
diff --git a/includes/js/dojo/_base/NodeList.js b/includes/js/dojo/_base/NodeList.js deleted file mode 100644 index c10e18d..0000000 --- a/includes/js/dojo/_base/NodeList.js +++ /dev/null @@ -1,532 +0,0 @@ -if(!dojo._hasResource["dojo._base.NodeList"]){ //_hasResource checks added by build. Do not use _hasResource directly in your code. -dojo._hasResource["dojo._base.NodeList"] = true; -dojo.provide("dojo._base.NodeList"); -dojo.require("dojo._base.lang"); -dojo.require("dojo._base.array"); - -(function(){ - - var d = dojo; - - var tnl = function(arr){ - // decorate an array to make it look like a NodeList - arr.constructor = dojo.NodeList; - dojo._mixin(arr, dojo.NodeList.prototype); - return arr; - } - - var _mapIntoDojo = function(func, alwaysThis){ - // returns a function which, when executed in the scope of its caller, - // applies the passed arguments to a particular dojo.* function (named - // in func) and aggregates the returns. if alwaysThis is true, it - // always returns the scope object and not the collected returns from - // the Dojo method - return function(){ - var _a = arguments; - var aa = d._toArray(_a, 0, [null]); - var s = this.map(function(i){ - aa[0] = i; - return d[func].apply(d, aa); - }); - return (alwaysThis || ( (_a.length > 1) || !d.isString(_a[0]) )) ? this : s; // String||dojo.NodeList - } - }; - - dojo.NodeList = function(){ - // summary: - // dojo.NodeList is as subclass of Array which adds syntactic - // sugar for chaining, common iteration operations, animation, - // and node manipulation. NodeLists are most often returned as - // the result of dojo.query() calls. - // example: - // create a node list from a node - // | new dojo.NodeList(dojo.byId("foo")); - - return tnl(Array.apply(null, arguments)); - } - - dojo.NodeList._wrap = tnl; - - dojo.extend(dojo.NodeList, { - // http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array#Methods - - // FIXME: handle return values for #3244 - // http://trac.dojotoolkit.org/ticket/3244 - - // FIXME: - // need to wrap or implement: - // join (perhaps w/ innerHTML/outerHTML overload for toString() of items?) - // reduce - // reduceRight - - slice: function(/*===== begin, end =====*/){ - // summary: - // Returns a new NodeList, maintaining this one in place - // description: - // This method behaves exactly like the Array.slice method - // with the caveat that it returns a dojo.NodeList and not a - // raw Array. For more details, see: - // http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:slice - // begin: Integer - // Can be a positive or negative integer, with positive - // integers noting the offset to begin at, and negative - // integers denoting an offset from the end (i.e., to the left - // of the end) - // end: Integer? - // Optional parameter to describe what position relative to - // the NodeList's zero index to end the slice at. Like begin, - // can be positive or negative. - var a = dojo._toArray(arguments); - return tnl(a.slice.apply(this, a)); - }, - - splice: function(/*===== index, howmany, item =====*/){ - // summary: - // Returns a new NodeList, manipulating this NodeList based on - // the arguments passed, potentially splicing in new elements - // at an offset, optionally deleting elements - // description: - // This method behaves exactly like the Array.splice method - // with the caveat that it returns a dojo.NodeList and not a - // raw Array. For more details, see: - // <http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:splice> - // index: Integer - // begin can be a positive or negative integer, with positive - // integers noting the offset to begin at, and negative - // integers denoting an offset from the end (i.e., to the left - // of the end) - // howmany: Integer? - // Optional parameter to describe what position relative to - // the NodeList's zero index to end the slice at. Like begin, - // can be positive or negative. - // item: Object...? - // Any number of optional parameters may be passed in to be - // spliced into the NodeList - // returns: - // dojo.NodeList - var a = dojo._toArray(arguments); - return tnl(a.splice.apply(this, a)); - }, - - concat: function(/*===== item =====*/){ - // summary: - // Returns a new NodeList comprised of items in this NodeList - // as well as items passed in as parameters - // description: - // This method behaves exactly like the Array.concat method - // with the caveat that it returns a dojo.NodeList and not a - // raw Array. For more details, see: - // <http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:concat> - // item: Object...? - // Any number of optional parameters may be passed in to be - // spliced into the NodeList - // returns: - // dojo.NodeList - var a = dojo._toArray(arguments, 0, [this]); - return tnl(a.concat.apply([], a)); - }, - - indexOf: function(/*Object*/ value, /*Integer?*/ fromIndex){ - // summary: - // see dojo.indexOf(). The primary difference is that the acted-on - // array is implicitly this NodeList - // value: - // The value to search for. - // fromIndex: - // The loction to start searching from. Optional. Defaults to 0. - // description: - // For more details on the behavior of indexOf, see: - // <http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:indexOf> - // returns: - // Positive Integer or 0 for a match, -1 of not found. - return d.indexOf(this, value, fromIndex); // Integer - }, - - lastIndexOf: function(/*===== value, fromIndex =====*/){ - // summary: - // see dojo.lastIndexOf(). The primary difference is that the - // acted-on array is implicitly this NodeList - // description: - // For more details on the behavior of lastIndexOf, see: - // <http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:lastIndexOf> - // value: Object - // The value to search for. - // fromIndex: Integer? - // The loction to start searching from. Optional. Defaults to 0. - // returns: - // Positive Integer or 0 for a match, -1 of not found. - return d.lastIndexOf.apply(d, d._toArray(arguments, 0, [this])); // Integer - }, - - every: function(/*Function*/callback, /*Object?*/thisObject){ - // summary: - // see `dojo.every()` and: - // <http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:every> - // Takes the same structure of arguments and returns as - // dojo.every() with the caveat that the passed array is - // implicitly this NodeList - return d.every(this, callback, thisObject); // Boolean - }, - - some: function(/*Function*/callback, /*Object?*/thisObject){ - // summary: - // see dojo.some() and: - // http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array:some - // Takes the same structure of arguments and returns as - // dojo.some() with the caveat that the passed array is - // implicitly this NodeList - return d.some(this, callback, thisObject); // Boolean - }, - - map: function(/*Function*/ func, /*Function?*/ obj){ - // summary: - // see dojo.map(). The primary difference is that the acted-on - // array is implicitly this NodeList and the return is a - // dojo.NodeList (a subclass of Array) - - return d.map(this, func, obj, d.NodeList); // dojo.NodeList - }, - - forEach: function(callback, thisObj){ - // summary: - // see dojo.forEach(). The primary difference is that the acted-on - // array is implicitly this NodeList - - d.forEach(this, callback, thisObj); - // non-standard return to allow easier chaining - return this; // dojo.NodeList - }, - - // custom methods - - coords: function(){ - // summary: - // Returns the box objects all elements in a node list as - // an Array (*not* a NodeList) - - return d.map(this, d.coords); // Array - }, - - /*===== - attr: function(property, value){ - // summary: - // gets or sets the DOM attribute for every element in the - // NodeList - // property: String - // the attribute to get/set - // value: String? - // optional. The value to set the property to - // return: - // if no value is passed, the result is an array of attribute values - // If a value is passed, the return is this NodeList - }, - - style: function(property, value){ - // summary: - // gets or sets the CSS property for every element in the NodeList - // property: String - // the CSS property to get/set, in JavaScript notation - // ("lineHieght" instead of "line-height") - // value: String? - // optional. The value to set the property to - // return: - // if no value is passed, the result is an array of strings. - // If a value is passed, the return is this NodeList - }, - - addClass: function(className){ - // summary: - // adds the specified class to every node in the list - // className: String - // the CSS class to add - // return: - // dojo.NodeList, this list - }, - - removeClass: function(className){ - // summary: - // removes the specified class from every node in the list - // className: String - // the CSS class to add - // return: - // dojo.NodeList, this list - }, - - toggleClass: function(className, condition){ - // summary: - // Adds a class to node if not present, or removes if present. - // Pass a boolean condition if you want to explicitly add or remove. - // condition: Boolean? - // If passed, true means to add the class, false means to remove. - // className: String - // the CSS class to add - // return: dojo.NodeList - // this list - }, - - connect: function(methodName, objOrFunc, funcName){ - // summary: - // attach event handlers to every item of the NodeList. Uses dojo.connect() - // so event properties are normalized - // methodName: String - // the name of the method to attach to. For DOM events, this should be - // the lower-case name of the event - // objOrFunc: Object|Function|String - // if 2 arguments are passed (methodName, objOrFunc), objOrFunc should - // reference a function or be the name of the function in the global - // namespace to attach. If 3 arguments are provided - // (methodName, objOrFunc, funcName), objOrFunc must be the scope to - // locate the bound function in - // funcName: String? - // optional. A string naming the function in objOrFunc to bind to the - // event. May also be a function reference. - // example: - // add an onclick handler to every button on the page - // | dojo.query("div:nth-child(odd)").connect("onclick", function(e){ - // | console.debug("clicked!"); - // | }); - // example: - // attach foo.bar() to every odd div's onmouseover - // | dojo.query("div:nth-child(odd)").connect("onmouseover", foo, "bar"); - }, - =====*/ - attr: _mapIntoDojo("attr"), - style: _mapIntoDojo("style"), - addClass: _mapIntoDojo("addClass", true), - removeClass: _mapIntoDojo("removeClass", true), - toggleClass: _mapIntoDojo("toggleClass", true), - connect: _mapIntoDojo("connect", true), - - // FIXME: connectPublisher()? connectRunOnce()? - - place: function(/*String||Node*/ queryOrNode, /*String*/ position){ - // summary: - // places elements of this node list relative to the first element matched - // by queryOrNode. Returns the original NodeList. - // queryOrNode: - // may be a string representing any valid CSS3 selector or a DOM node. - // In the selector case, only the first matching element will be used - // for relative positioning. - // position: - // can be one of: - // * "last"||"end" (default) - // * "first||"start" - // * "before" - // * "after" - // or an offset in the childNodes property - var item = d.query(queryOrNode)[0]; - return this.forEach(function(i){ d.place(i, item, (position||"last")); }); // dojo.NodeList - }, - - orphan: function(/*String?*/ simpleFilter){ - // summary: - // removes elements in this list that match the simple - // filter from their parents and returns them as a new - // NodeList. - // simpleFilter: - // single-expression CSS filter - // return: - // `dojo.NodeList` the orpahned elements - var orphans = simpleFilter ? d._filterQueryResult(this, simpleFilter) : this; - orphans.forEach(function(item){ - if(item.parentNode){ - item.parentNode.removeChild(item); - } - }); - return orphans; // dojo.NodeList - }, - - adopt: function(/*String||Array||DomNode*/ queryOrListOrNode, /*String?*/ position){ - // summary: - // places any/all elements in queryOrListOrNode at a - // position relative to the first element in this list. - // Returns a dojo.NodeList of the adopted elements. - // queryOrListOrNode: - // a DOM node or a query string or a query result. - // Represents the nodes to be adopted relative to the - // first element of this NodeList. - // position: - // can be one of: - // * "last"||"end" (default) - // * "first||"start" - // * "before" - // * "after" - // or an offset in the childNodes property - var item = this[0]; - return d.query(queryOrListOrNode).forEach(function(ai){ d.place(ai, item, position || "last"); }); // dojo.NodeList - }, - - // FIXME: do we need this? - query: function(/*String*/ queryStr){ - // summary: - // Returns a new, flattened NodeList. Elements of the new list - // satisfy the passed query but use elements of the - // current NodeList as query roots. - - if(!queryStr){ return this; } - - // FIXME: probably slow - // FIXME: use map? - var ret = d.NodeList(); - this.forEach(function(item){ - d.query(queryStr, item).forEach(function(subItem){ - if(subItem !== undefined){ - ret.push(subItem); - } - }); - }); - return ret; // dojo.NodeList - }, - - filter: function(/*String*/ simpleQuery){ - // summary: - // "masks" the built-in javascript filter() method to support - // passing a simple string filter in addition to supporting - // filtering function objects. - // example: - // "regular" JS filter syntax as exposed in dojo.filter: - // | dojo.query("*").filter(function(item){ - // | // highlight every paragraph - // | return (item.nodeName == "p"); - // | }).styles("backgroundColor", "yellow"); - // example: - // the same filtering using a CSS selector - // | dojo.query("*").filter("p").styles("backgroundColor", "yellow"); - - var items = this; - var _a = arguments; - var r = d.NodeList(); - var rp = function(t){ - if(t !== undefined){ - r.push(t); - } - } - if(d.isString(simpleQuery)){ - items = d._filterQueryResult(this, _a[0]); - if(_a.length == 1){ - // if we only got a string query, pass back the filtered results - return items; // dojo.NodeList - } - // if we got a callback, run it over the filtered items - _a.shift(); - } - // handle the (callback, [thisObject]) case - d.forEach(d.filter(items, _a[0], _a[1]), rp); - return r; // dojo.NodeList - }, - - /* - // FIXME: should this be "copyTo" and include parenting info? - clone: function(){ - // summary: - // creates node clones of each element of this list - // and returns a new list containing the clones - }, - */ - - addContent: function(/*String*/ content, /*String||Integer?*/ position){ - // summary: - // add a node or some HTML as a string to every item in the list. - // Returns the original list. - // description: - // a copy of the HTML content is added to each item in the - // list, with an optional position argument. If no position - // argument is provided, the content is appended to the end of - // each item. - // content: - // the HTML in string format to add at position to every item - // position: - // can be one of: - // * "last"||"end" (default) - // * "first||"start" - // * "before" - // * "after" - // or an offset in the childNodes property - // example: - // appends content to the end if the position is ommitted - // | dojo.query("h3 > p").addContent("hey there!"); - // example: - // add something to the front of each element that has a "thinger" property: - // | dojo.query("[thinger]").addContent("...", "first"); - // example: - // adds a header before each element of the list - // | dojo.query(".note").addContent("<h4>NOTE:</h4>", "before"); - var ta = d.doc.createElement("span"); - if(d.isString(content)){ - ta.innerHTML = content; - }else{ - ta.appendChild(content); - } - if(position === undefined){ - position = "last"; - } - var ct = (position == "first" || position == "after") ? "lastChild" : "firstChild"; - this.forEach(function(item){ - var tn = ta.cloneNode(true); - while(tn[ct]){ - d.place(tn[ct], item, position); - } - }); - return this; // dojo.NodeList - }, - - empty: function(){ - // summary: - // clears all content from each node in the list - return this.forEach("item.innerHTML='';"); // dojo.NodeList - - // FIXME: should we be checking for and/or disposing of widgets below these nodes? - }, - - instantiate: function(/*String|Object*/ declaredClass, /*Object?*/ properties){ - // summary: - // Create a new instance of a specified class, using the - // specified properties and each node in the nodeList as a - // srcNodeRef - // - var c = d.isFunction(declaredClass) ? declaredClass : d.getObject(declaredClass); - return this.forEach(function(i){ - new c(properties||{},i); - }) // dojo.NodeList - } - - }); - - // syntactic sugar for DOM events - d.forEach([ - "blur", "focus", "click", "keydown", "keypress", "keyup", "mousedown", - "mouseenter", "mouseleave", "mousemove", "mouseout", "mouseover", - "mouseup" - ], function(evt){ - var _oe = "on"+evt; - dojo.NodeList.prototype[_oe] = function(a, b){ - return this.connect(_oe, a, b); - } - // FIXME: should these events trigger publishes? - /* - return (a ? this.connect(_oe, a, b) : - this.forEach(function(n){ - // FIXME: - // listeners get buried by - // addEventListener and can't be dug back - // out to be triggered externally. - // see: - // http://developer.mozilla.org/en/docs/DOM:element - - console.debug(n, evt, _oe); - - // FIXME: need synthetic event support! - var _e = { target: n, faux: true, type: evt }; - // dojo._event_listener._synthesizeEvent({}, { target: n, faux: true, type: evt }); - try{ n[evt](_e); }catch(e){ console.debug(e); } - try{ n[_oe](_e); }catch(e){ console.debug(e); } - }) - ); - } - */ - } - ); - -})(); - -} |