Test Paragraph.
+ * @result red + * + * @name css + * @type Object + * @param String name The name of the property to access. + */ + + /** + * Set a hash of key/value style properties to all matched elements. + * This serves as the best way to set a large number of style properties + * on all matched elements. + * + * @example $("p").css({ color: "red", background: "blue" }); + * @beforeTest Paragraph.
+ * @resultTest Paragraph.
+ * + * @name css + * @type jQuery + * @param Hash prop A set of key/value pairs to set as style properties. + */ + + /** + * Set a single style property to a value, on all matched elements. + * + * @example $("p").css("color","red"); + * @beforeTest Paragraph.
+ * @resultTest Paragraph.
+ * + * @name css + * @type jQuery + * @param String key The name of the property to set. + * @param Object value The value to set the property to. + */ + css: function( key, value ) { + return this.attr( key, value, "curCSS" ); + }, + + /** + * Retreive the text contents of all matched elements. The result is + * a string that contains the combined text contents of all matched + * elements. This method works on both HTML and XML documents. + * + * @example $("p").text(); + * @beforeTest Paragraph.
+ * @result Test Paragraph. + * + * @name text + * @type String + */ + text: function(e) { + e = e || this; + var t = ""; + for ( var j = 0; j < e.length; j++ ) { + var r = e[j].childNodes; + for ( var i = 0; i < r.length; i++ ) + t += r[i].nodeType != 1 ? + r[i].nodeValue : jQuery.fn.text([ r[i] ]); + } + return t; + }, + + /** + * Wrap all matched elements with a structure of other elements. + * This wrapping process is most useful for injecting additional + * stucture into a document, without ruining the original semantic + * qualities of a document. + * + * The way that is works is that it goes through the first element argument + * provided and finds the deepest element within the structure - it is that + * element that will en-wrap everything else. + * + * @example $("p").wrap(""); + * @beforeTest Paragraph.
+ * @resultTest Paragraph.
I would like to say:
+ * @resultI would like to say: Hello
+ * + * @name append + * @type jQuery + * @any String html A string of HTML, that will be created on the fly and appended to the target. + * @any Element elem A DOM element that will be appended. + * @any Array, how are you?
+ * @resultHello, how are you?
+ * + * @name prepend + * @type jQuery + * @any String html A string of HTML, that will be created on the fly and prepended to the target. + * @any Element elem A DOM element that will be prepended. + * @any Arrayhow are you?
+ * @result Hellohow are you?
+ * + * @name before + * @type jQuery + * @any String html A string of HTML, that will be created on the fly and inserted. + * @any Element elem A DOM element that will beinserted. + * @any ArrayI'm doing fine.
"); + * @beforeHow are you?
+ * @resultHow are you?
I'm doing fine.
+ * + * @name after + * @type jQuery + * @any String html A string of HTML, that will be created on the fly and inserted. + * @any Element elem A DOM element that will beinserted. + * @any ArrayHello, how are you?
+ * @result $("p").find("span").end() == [...
] + * + * @name end + * @type jQuery + */ + end: function() { + return this.get( this.stack.pop() ); + }, + + /** + * Searches for all elements that match the specified expression. + * This method is the optimal way of finding additional descendant + * elements with which to process. + * + * All searching is done using a jQuery expression. The expression can be + * written using CSS 1-3 Selector syntax, or basic XPath. + * + * @example $("p").find("span"); + * @beforeHello, how are you?
+ * @result $("p").find("span") == [ Hello ] + * + * @name find + * @type jQuery + * @param String expr An expression to search with. + */ + find: function(t) { + return this.pushStack( jQuery.map( this, function(a){ + return jQuery.find(t,a); + }), arguments ); + }, + + /** + * Removes all elements from the set of matched elements that do not + * match the specified expression. This method is used to narrow down + * the results of a search. + * + * All searching is done using a jQuery expression. The expression + * can be written using CSS 1-3 Selector syntax, or basic XPath. + * + * @example $("p").filter(".selected") + * @beforeHello
How are you?
+ * @result $("p").filter(".selected") == [Hello
] + * + * @name filter + * @type jQuery + * @param String expr An expression to search with. + */ - appendTo: function() { - var a = arguments; - return this.each(function(){ - for ( var i = 0; i < a.length; i++ ) - $(a[i]).append( this ); - }); - }, + /** + * Removes all elements from the set of matched elements that do not + * match at least one of the expressions passed to the function. This + * method is used when you want to filter the set of matched elements + * through more than one expression. + * + * Elements will be retained in the jQuery object if they match at + * least one of the expressions passed. + * + * @example $("p").filter([".selected", ":first"]) + * @beforeHello
Hello Again
And Again
+ * @result $("p").filter([".selected", ":first"]) == [Hello
,And Again
] + * + * @name filter + * @type jQuery + * @param ArrayHello
Hello Again
+ * @result [Hello
] + * + * @name not + * @type jQuery + * @param Element el An element to remove from the set + */ + + /** + * Removes elements matching the specified expression from the set + * of matched elements. This method is used to remove one or more + * elements from a jQuery object. + * + * @example $("p").not("#selected") + * @beforeHello
Hello Again
+ * @result [Hello
] + * + * @name not + * @type jQuery + * @param String expr An expression with which to remove matching elements + */ + not: function(t) { + return this.pushStack( t.constructor == String ? + jQuery.filter(t,this,false).r : + jQuery.grep(this,function(a){ return a != t; }), arguments ); + }, + + /** + * Adds the elements matched by the expression to the jQuery object. This + * can be used to concatenate the result sets of two expressions. + * + * @example $("p").add("span") + * @beforeHello
Hello Again
+ * @result [Hello
, Hello Again ] + * + * @name add + * @type jQuery + * @param String expr An expression whose matched elements are added + */ + + /** + * Adds each of the Elements in the array to the set of matched elements. + * This is used to add a set of Elements to a jQuery object. + * + * @example $("p").add([document.getElementById("a"), document.getElementById("b")]) + * @beforeHello
Hello AgainAnd Again
+ * @result [Hello
, Hello Again, And Again ] + * + * @name add + * @type jQuery + * @param ArrayHello
Hello Again
+ * @result [Hello
, Hello Again ] + * + * @name add + * @type jQuery + * @param Element el An Element to add + */ + add: function(t) { + return this.pushStack( jQuery.merge( this, t.constructor == String ? + jQuery.find(t) : t.constructor == Array ? t : [t] ), arguments ); + }, + + /** + * A wrapper function for each() to be used by append and prepend. + * Handles cases where you're trying to modify the inner contents of + * a table, when you actually need to work with the tbody. + * + * @member jQuery + * @param {String} expr The expression with which to filter + * @type Boolean + */ + is: function(expr) { + return expr ? jQuery.filter(expr,this).r.length > 0 : this.length > 0; + }, + + /** + * + * + * @private + * @name domManip + * @param Array args + * @param Boolean table + * @param Number int + * @param Function fn The function doing the DOM manipulation. + * @type jQuery + */ + domManip: function(args, table, dir, fn){ + var clone = this.size() > 1; + var a = jQuery.clean(args); - prepend: function() { - var clone = this.size() > 1; - var a = $.clean(arguments); - return this.each(function(){ - for ( var i = a.length - 1; i >= 0; i-- ) - this.insertBefore( clone ? a[i].cloneNode(true) : a[i], this.firstChild ); - }); - }, + return this.each(function(){ + var obj = this; + + if ( table && this.nodeName == "TABLE" ) { + var tbody = this.getElementsByTagName("tbody"); + + if ( !tbody.length ) { + obj = document.createElement("tbody"); + this.appendChild( obj ); + } else + obj = tbody[0]; + } + + for ( var i = ( dir < 0 ? a.length - 1 : 0 ); + i != ( dir < 0 ? dir : a.length ); i += dir ) { + fn.apply( obj, [ clone ? a[i].cloneNode(true) : a[i] ] ); + } + }); + }, + + /** + * + * + * @private + * @name pushStack + * @param Array a + * @param Array args + * @type jQuery + */ + pushStack: function(a,args) { + var fn = args && args[args.length-1]; + + if ( !fn || fn.constructor != Function ) { + if ( !this.stack ) this.stack = []; + this.stack.push( this.get() ); + this.get( a ); + } else { + var old = this.get(); + this.get( a ); + if ( fn.constructor == Function ) + return this.each( fn ); + this.get( old ); + } + + return this; + } +}; + +/** + * + * + * @private + * @name extend + * @param Object obj + * @param Object prop + * @type Object + */ + +/** + * Extend one object with another, returning the original, + * modified, object. This is a great utility for simple inheritance. + * + * @name $.extend + * @param Object obj The object to extend + * @param Object prop The object that will be merged into the first. + * @type Object + */ +jQuery.extend = jQuery.fn.extend = function(obj,prop) { + if ( !prop ) { prop = obj; obj = this; } + for ( var i in prop ) obj[i] = prop[i]; + return obj; +}; + +jQuery.extend({ + /** + * + * + * @private + * @name init + * @type undefined + */ + init: function(){ + jQuery.initDone = true; - before: function() { - var clone = this.size() > 1; - var a = $.clean(arguments); - return this.each(function(){ - for ( var i in a ) - this.parentNode.insertBefore( clone ? a[i].cloneNode(true) : a[i], this ); - }); - }, + jQuery.each( jQuery.macros.axis, function(i,n){ + jQuery.fn[ i ] = function(a) { + var ret = jQuery.map(this,n); + if ( a && a.constructor == String ) + ret = jQuery.filter(a,ret).r; + return this.pushStack( ret, arguments ); + }; + }); - after: function() { - var clone = this.size() > 1; - var a = $.clean(arguments); - return this.each(function(){ - for ( var i = a.length - 1; i >= 0; i-- ) - this.parentNode.insertBefore( clone ? a[i].cloneNode(true) : a[i], this.nextSibling ); - }); - }, - - empty: function() { - return this.each(function(){ - while ( this.firstChild ) - this.removeChild( this.firstChild ); - }); - }, + jQuery.each( jQuery.macros.to, function(i,n){ + jQuery.fn[ i ] = function(){ + var a = arguments; + return this.each(function(){ + for ( var j = 0; j < a.length; j++ ) + $(a[j])[n]( this ); + }); + }; + }); - bind: function(t,f) { - return this.each(function(){addEvent(this,t,f);}); - }, - unbind: function(t,f) { - return this.each(function(){removeEvent(this,t,f);}); - }, - trigger: function(t) { - return this.each(function(){triggerEvent(this,t);}); - }, + jQuery.each( jQuery.macros.each, function(i,n){ + jQuery.fn[ i ] = function() { + return this.each( n, arguments ); + }; + }); - find: function(t) { - var old = [], ret = []; - this.each(function(){ - old[old.length] = this; - ret = $.merge( ret, $.Select(t,this) ); - }); - this.old = old; - this.cur = ret; - return this; + jQuery.each( jQuery.macros.attr, function(i,n){ + n = n || i; + jQuery.fn[ i ] = function(h) { + return h == undefined ? + this.length ? this[0][n] : null : + this.attr( n, h ); + }; + }); + + jQuery.each( jQuery.macros.css, function(i,n){ + jQuery.fn[ i ] = function(h) { + return h == undefined ? + ( this.length ? jQuery.css( this[0], n ) : null ) : + this.css( n, h ); + }; + }); + + }, + + /** + * A generic iterator function, which can be used to seemlessly + * iterate over both objects and arrays. + * + * @name $.each + * @param Object obj The object, or array, to iterate over. + * @param Object fn The function that will be executed on every object. + * @type Object + */ + each: function( obj, fn, args ) { + if ( obj.length == undefined ) + for ( var i in obj ) + fn.apply( obj[i], args || [i, obj[i]] ); + else + for ( var i = 0; i < obj.length; i++ ) + fn.apply( obj[i], args || [i, obj[i]] ); + return obj; + }, + + className: { + add: function(o,c){ + if (jQuery.className.has(o,c)) return; + o.className += ( o.className ? " " : "" ) + c; }, - end: function() { - this.cur = this.old; - return this; + remove: function(o,c){ + o.className = !c ? "" : + o.className.replace( + new RegExp("(^|\\s*\\b[^-])"+c+"($|\\b(?=[^-]))", "g"), ""); }, - - parent: function(a) { - if ( a == null ) a = 1; - this.cur = $.map(this.cur,function(d){ - var b = $.parents(d); - if ( a == 0 ) - return b; - else if ( a.constructor == String ) { - var c = $.filter(a,b); - return c.length > 0 ? c[0] : null; + has: function(e,a) { + if ( e.className ) + e = e.className; + return new RegExp("(^|\\s)" + a + "(\\s|$)").test(e); + } + }, + + /** + * Swap in/out style options. + * @private + */ + swap: function(e,o,f) { + for ( var i in o ) { + e.style["old"+i] = e.style[i]; + e.style[i] = o[i]; + } + f.apply( e, [] ); + for ( var i in o ) + e.style[i] = e.style["old"+i]; + }, + + css: function(e,p) { + if ( p == "height" || p == "width" ) { + var old = {}, oHeight, oWidth, d = ["Top","Bottom","Right","Left"]; + + for ( var i in d ) { + old["padding" + d[i]] = 0; + old["border" + d[i] + "Width"] = 0; + } + + jQuery.swap( e, old, function() { + if (jQuery.css(e,"display") != "none") { + oHeight = e.offsetHeight; + oWidth = e.offsetWidth; } else - return b.length >= a ? b[a-1] : null; + jQuery.swap( e, { visibility: "hidden", position: "absolute", display: "" }, + function(){ + oHeight = e.clientHeight; + oWidth = e.clientWidth; + }); }); - return this; - }, - - parents: function(a) { - return this; - }, + + return p == "height" ? oHeight : oWidth; + } else if ( p == "opacity" && jQuery.browser.msie ) + return parseFloat( jQuery.curCSS(e,"filter").replace(/[^0-9.]/,"") ) || 1; + + return jQuery.curCSS( e, p ); + }, + + curCSS: function(e,p,force) { + var r; + + if (!force && e.style[p]) + r = e.style[p]; + else if (e.currentStyle) { + p = p.replace(/\-(\w)/g,function(m,c){return c.toUpperCase()}); + r = e.currentStyle[p]; + } else if (document.defaultView && document.defaultView.getComputedStyle) { + p = p.replace(/([A-Z])/g,"-$1").toLowerCase(); + var s = document.defaultView.getComputedStyle(e,""); + r = s ? s.getPropertyValue(p) : null; + } - filter: function(t) { - this.cur = $.filter(t,this.cur).r; - return this; - }, - not: function(t) { - this.cur = t.constructor == String ? - $.filter(t,this.cur,false).r : - $.grep(this.cur,function(a){return a != t;}); - return this; - }, - add: function(t) { - this.cur = $.merge( this.cur, t.constructor == String ? - $.Select(t) : t.constructor == Array ? t : [t] ); - return this; + return r; + }, + + clean: function(a) { + var r = []; + for ( var i = 0; i < a.length; i++ ) { + if ( a[i].constructor == String ) { + + if ( !a[i].indexOf("I would like to say:
+ * @resultI would like to say:
I would like to say:
I would like to say:
HelloI would like to say:
+ * @resultI would like to say:
I would like to say:
I would like to say:
+ * + * @name insertAfter + * @type jQuery + * @param String expr A jQuery expression of elements to match. + */ + after: "insertAfter" + }, + + /** + * Get the current CSS width of the first matched element. + * + * @example $("p").width(); + * @beforeThis is just a test.
+ * @result "300px" + * + * @name width + * @type String + */ + + /** + * Set the CSS width of every matched element. Be sure to include + * the "px" (or other unit of measurement) after the number that you + * specify, otherwise you might get strange results. + * + * @example $("p").width("20px"); + * @beforeThis is just a test.
+ * @resultThis is just a test.
+ * + * @name width + * @type jQuery + * @param String val Set the CSS property to the specified value. + */ + + /** + * Get the current CSS height of the first matched element. + * + * @example $("p").height(); + * @beforeThis is just a test.
+ * @result "14px" + * + * @name height + * @type String + */ + + /** + * Set the CSS height of every matched element. Be sure to include + * the "px" (or other unit of measurement) after the number that you + * specify, otherwise you might get strange results. + * + * @example $("p").height("20px"); + * @beforeThis is just a test.
+ * @resultThis is just a test.
+ * + * @name height + * @type jQuery + * @param String val Set the CSS property to the specified value. + */ + + /** + * Get the current CSS top of the first matched element. + * + * @example $("p").top(); + * @beforeThis is just a test.
+ * @result "0px" + * + * @name top + * @type String + */ + + /** + * Set the CSS top of every matched element. Be sure to include + * the "px" (or other unit of measurement) after the number that you + * specify, otherwise you might get strange results. + * + * @example $("p").top("20px"); + * @beforeThis is just a test.
+ * @resultThis is just a test.
+ * + * @name top + * @type jQuery + * @param String val Set the CSS property to the specified value. + */ + + /** + * Get the current CSS left of the first matched element. + * + * @example $("p").left(); + * @beforeThis is just a test.
+ * @result "0px" + * + * @name left + * @type String + */ + + /** + * Set the CSS left of every matched element. Be sure to include + * the "px" (or other unit of measurement) after the number that you + * specify, otherwise you might get strange results. + * + * @example $("p").left("20px"); + * @beforeThis is just a test.
+ * @resultThis is just a test.
+ * + * @name left + * @type jQuery + * @param String val Set the CSS property to the specified value. + */ + + /** + * Get the current CSS position of the first matched element. + * + * @example $("p").position(); + * @beforeThis is just a test.
+ * @result "static" + * + * @name position + * @type String + */ + + /** + * Set the CSS position of every matched element. + * + * @example $("p").position("relative"); + * @beforeThis is just a test.
+ * @resultThis is just a test.
+ * + * @name position + * @type jQuery + * @param String val Set the CSS property to the specified value. + */ + + /** + * Get the current CSS float of the first matched element. + * + * @example $("p").float(); + * @beforeThis is just a test.
+ * @result "none" + * + * @name float + * @type String + */ + + /** + * Set the CSS float of every matched element. + * + * @example $("p").float("left"); + * @beforeThis is just a test.
+ * @resultThis is just a test.
+ * + * @name float + * @type jQuery + * @param String val Set the CSS property to the specified value. + */ + + /** + * Get the current CSS overflow of the first matched element. + * + * @example $("p").overflow(); + * @beforeThis is just a test.
+ * @result "none" + * + * @name overflow + * @type String + */ + + /** + * Set the CSS overflow of every matched element. + * + * @example $("p").overflow("auto"); + * @beforeThis is just a test.
+ * @resultThis is just a test.
+ * + * @name overflow + * @type jQuery + * @param String val Set the CSS property to the specified value. + */ + + /** + * Get the current CSS color of the first matched element. + * + * @example $("p").color(); + * @beforeThis is just a test.
+ * @result "black" + * + * @name color + * @type String + */ + + /** + * Set the CSS color of every matched element. + * + * @example $("p").color("blue"); + * @beforeThis is just a test.
+ * @resultThis is just a test.
+ * + * @name color + * @type jQuery + * @param String val Set the CSS property to the specified value. + */ + + /** + * Get the current CSS background of the first matched element. + * + * @example $("p").background(); + * @beforeThis is just a test.
+ * @result "" + * + * @name background + * @type String + */ + + /** + * Set the CSS background of every matched element. + * + * @example $("p").background("blue"); + * @beforeThis is just a test.
+ * @resultThis is just a test.
+ * + * @name background + * @type jQuery + * @param String val Set the CSS property to the specified value. + */ + + css: "width,height,top,left,position,float,overflow,color,background".split(","), -$.hasWord = function(e,a) { - if ( e == null ) return false; - if ( e.className != null ) e = e.className; - return new RegExp("(^|\\s)" + a + "(\\s|$)").test(e) -}; + attr: { + /** + * Get the current value of the first matched element. + * + * @example $("input").val(); + * @before + * @result "some text" + * + * @name val + * @type String + */ + + /** + * Set the value of every matched element. + * + * @example $("input").value("test"); + * @before + * @result + * + * @name val + * @type jQuery + * @param String val Set the property to the specified value. + */ + val: "value", + + /** + * Get the html contents of the first matched element. + * + * @example $("div").html(); + * @before + * @result + * + * @name html + * @type String + */ + + /** + * Set the html contents of every matched element. + * + * @example $("div").html("new stuff"); + * @before + * @resultHello
Hello
Hello
Hello
Hello
Hello Again
Hello Again
Hello
Hello AgainHello
] + * + * @name ancestors + * @type jQuery + */ -$.grep = function(a,f,s) { - var r = []; - if ( a != null ) - for ( var i = 0; i < a.length; i++ ) - if ( (!s && f(a[i],i)) || (s && !f(a[i],i)) ) - r[r.length] = a[i]; - return r; -}; + /** + * Get a set of elements containing the unique ancestors of the matched + * set of elements, and filtered by an expression. + * + * @example $("span").ancestors("p") + * @beforeHello
Hello AgainHello
] + * + * @name ancestors + * @type jQuery + * @param String expr An expression to filter the ancestors with + */ + ancestors: jQuery.parents, + + /** + * Get a set of elements containing the unique ancestors of the matched + * set of elements. + * + * @example $("span").ancestors() + * @beforeHello
Hello AgainHello
] + * + * @name parents + * @type jQuery + */ -$.map = function(a,f) { - var r = []; - for ( var i = 0; i < a.length; i++ ) { - var t = f(a[i],i); - if ( t != null ) { - if ( t.constructor != Array ) t = [t]; - r = $.merge( t, r ); - } - } - return r; -}; + /** + * Get a set of elements containing the unique ancestors of the matched + * set of elements, and filtered by an expression. + * + * @example $("span").ancestors("p") + * @beforeHello
Hello AgainHello
] + * + * @name parents + * @type jQuery + * @param String expr An expression to filter the ancestors with + */ + parents: jQuery.parents, -// Bind an event to an element -// Original by Dean Edwards -function addEvent(element, type, handler) { - if ( element.location ) element = window; // Ughhhhh.... - if (!handler.$$guid) handler.$$guid = addEvent.guid++; - if (!element.events) element.events = {}; - var handlers = element.events[type]; - if (!handlers) { - handlers = element.events[type] = {}; - if (element["on" + type]) - handlers[0] = element["on" + type]; - } - handlers[handler.$$guid] = handler; - element["on" + type] = handleEvent; -}; -addEvent.guid = 1; - -// Detach an event or set of events from an element -function removeEvent(element, type, handler) { - if (element.events) { - if (type && element.events[type]) { - if ( handler ) { - delete element.events[type][handler.$$guid]; - } else { - for ( var i in element.events[type] ) - delete element.events[type][i]; - } - } else { - for ( var i in element.events ) - removeEvent( element, i ); - } - } -}; + /** + * Get a set of elements containing the unique next siblings of each of the + * matched set of elements. + * + * It only returns the very next sibling, not all next siblings. + * + * @example $("p").next() + * @beforeHello
Hello Again
Hello Again
,Hello
Hello Again
Hello Again
] + * + * @name next + * @type jQuery + * @param String expr An expression to filter the next Elements with + */ + next: "jQuery.sibling(a).next", -function handleEvent(event) { - var returnValue = true; - event = event || fixEvent(window.event); - var handlers = []; - for ( var i in this.events[event.type] ) - handlers[handlers.length] = this.events[event.type][i]; - for ( var i = 0; i < handlers.length; i++ ) { - try { - if ( handlers[i].constructor == Function ) { - this.$$handleEvent = handlers[i]; - if (this.$$handleEvent(event) === false) { - event.preventDefault(); - event.stopPropagation(); - returnValue = false; - } - } - } catch(e){} - } - return returnValue; -}; + /** + * Get a set of elements containing the unique previous siblings of each of the + * matched set of elements. + * + * It only returns the immediately previous sibling, not all previous siblings. + * + * @example $("p").previous() + * @beforeHello
And Again
+ * @result [Hello Again
And Again
+ * @result [Hello
And Again
+ * @result [Hello
,And Again
] + * + * @name siblings + * @type jQuery + */ -$.fn.text = function(e) { - e = e || this.cur; - var t = ""; - for ( var j = 0; j < e.length; j++ ) { - for ( var i = 0; i < e[j].childNodes.length; i++ ) - t += e[j].childNodes[i].nodeType != 1 ? - e[j].childNodes[i].nodeValue : - $.fn.text(e[j].childNodes[i].childNodes); + /** + * Get a set of elements containing all of the unique siblings of each of the + * matched set of elements, and filtered by an expression. + * + * @example $("div").siblings(".selected") + * @beforeHello Again
And Again
+ * @result [Hello Again
] + * + * @name siblings + * @type jQuery + * @param String expr An expression to filter the sibling Elements with + */ + siblings: jQuery.sibling, + + + /** + * Get a set of elements containing all of the unique children of each of the + * matched set of elements. + * + * @example $("div").children() + * @beforeHello
And Again
+ * @result [ Hello Again ] + * + * @name children + * @type jQuery + */ + + /** + * Get a set of elements containing all of the unique siblings of each of the + * matched set of elements, and filtered by an expression. + * + * @example $("div").children(".selected") + * @beforeHello Again
And Again
Hello Again
] + * + * @name children + * @type jQuery + * @param String expr An expression to filter the child Elements with + */ + children: "a.childNodes" + }, + + each: { + /** + * Displays each of the set of matched elements if they are hidden. + * + * @example $("p").show() + * @before + * @result [Hello
] + * + * @name show + * @type jQuery + */ + _show: function(){ + this.style.display = this.oldblock ? this.oldblock : ""; + if ( jQuery.css(this,"display") == "none" ) + this.style.display = "block"; + }, + + /** + * Hides each of the set of matched elements if they are shown. + * + * @example $("p").hide() + * @beforeHello
+ * @result [ ] + * + * @name hide + * @type jQuery + */ + _hide: function(){ + this.oldblock = this.oldblock || jQuery.css(this,"display"); + if ( this.oldblock == "none" ) + this.oldblock = "block"; + this.style.display = "none"; + }, + + /** + * Toggles each of the set of matched elements. If they are shown, + * toggle makes them hidden. If they are hidden, toggle + * makes them shown. + * + * @example $("p").toggle() + * @beforeHello
+ * @result [ ,Hello Again
] + * + * @name toggle + * @type jQuery + */ + _toggle: function(){ + var d = jQuery.css(this,"display"); + $(this)[ !d || d == "none" ? "show" : "hide" ](); + }, + + /** + * Adds the specified class to each of the set of matched elements. + * + * @example ("p").addClass("selected") + * @beforeHello
+ * @result [Hello
] + * + * @name addClass + * @type jQuery + * @param String class A CSS class to add to the elements + */ + addClass: function(c){ + jQuery.className.add(this,c); + }, + + /** + * The opposite of addClass. Removes the specified class from the + * set of matched elements. + * + * @example ("p").removeClass("selected") + * @beforeHello
+ * @result [Hello
] + * + * @name removeClass + * @type jQuery + * @param String class A CSS class to remove from the elements + */ + removeClass: function(c){ + jQuery.className.remove(this,c); + }, + + /** + * Adds the specified class if it is present. Remove it if it is + * not present. + * + * @example ("p").toggleClass("selected") + * @beforeHello
Hello Again
+ * @result [Hello
,Hello Again
] + * + * @name toggleClass + * @type jQuery + * @param String class A CSS class with which to toggle the elements + */ + toggleClass: function( c ){ + jQuery.className[ jQuery.className.has(this,c) ? "remove" : "add" ](this,c); + }, + + /** + * TODO: Document + */ + remove: function(a){ + if ( !a || jQuery.filter( [this], a ).r ) + this.parentNode.removeChild( this ); + }, + + /** + * Removes all child nodes from the set of matched elements. + * + * @example ("p").empty() + * @beforeHello, Person and person
+ * @result [ ] + * + * @name empty + * @type jQuery + */ + empty: function(){ + while ( this.firstChild ) + this.removeChild( this.firstChild ); + }, + + /** + * Binds a particular event (like click) to a each of a set of match elements. + * + * @example $("p").bind( "click", function() { alert("Hello"); } ) + * @beforeHello
+ * @result [Hello
] + * + * Cancel a default action and prevent it from bubbling by returning false + * from your function. + * + * @example $("form").bind( "submit", function() { return false; } ) + * + * Cancel a default action by using the preventDefault method. + * + * @example $("form").bind( "submit", function() { e.preventDefault(); } ) + * + * Stop an event from bubbling by using the stopPropogation method. + * + * @example $("form").bind( "submit", function() { e.stopPropogation(); } ) + * + * @name bind + * @type jQuery + * @param String type An event type + * @param Function fn A function to bind to the event on each of the set of matched elements + */ + bind: function( type, fn ) { + if ( fn.constructor == String ) + fn = new Function("e", ( !fn.indexOf(".") ? "$(this)" : "return " ) + fn); + jQuery.event.add( this, type, fn ); + }, + + /** + * The opposite of bind, removes a bound event from each of the matched + * elements. You must pass the identical function that was used in the original + * bind method. + * + * @example $("p").unbind( "click", function() { alert("Hello"); } ) + * @beforeHello
+ * @result [Hello
] + * + * @name unbind + * @type jQuery + * @param String type An event type + * @param Function fn A function to unbind from the event on each of the set of matched elements + */ + + /** + * Removes all bound events of a particular type from each of the matched + * elements. + * + * @example $("p").unbind( "click" ) + * @beforeHello
+ * @result [Hello
] + * + * @name unbind + * @type jQuery + * @param String type An event type + */ + + /** + * Removes all bound events from each of the matched elements. + * + * @example $("p").unbind() + * @beforeHello
+ * @result [Hello
] + * + * @name unbind + * @type jQuery + */ + unbind: function( type, fn ) { + jQuery.event.remove( this, type, fn ); + }, + + /** + * Trigger a type of event on every matched element. + * + * @example $("p").trigger("click") + * @beforeHello
+ * @result alert('hello') + * + * @name trigger + * @type jQuery + * @param String type An event type to trigger. + */ + trigger: function( type, data ) { + jQuery.event.trigger( type, data, this ); + } } - return t; }; - -setTimeout(function(){ - if ( typeof Prototype != "undefined" && $.g == null && $.clean == null ) - throw "Error: You are overwriting jQuery, please include jQuery last."; -}, 1000);