Test Paragraph.
+ * @result red + * * @name css * @type Object * @param String name The name of the property to access. @@ -242,6 +283,10 @@ jQuery.fn = jQuery.prototype = { * 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. @@ -250,13 +295,17 @@ jQuery.fn = jQuery.prototype = { /** * 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, "css" ); + return this.attr( key, value, "curCSS" ); }, /** @@ -264,6 +313,10 @@ jQuery.fn = jQuery.prototype = { * 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 */ @@ -280,44 +333,125 @@ jQuery.fn = jQuery.prototype = { }, /** - * Set a single style property to a value, on all matched elements. + * 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. + */ + + /** + * 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. * - * @private * @member jQuery - * @param {Function} fn The function doing the DOM manipulation. + * @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){ @@ -350,13 +663,23 @@ jQuery.fn = jQuery.prototype = { } else obj = tbody[0]; } - + for ( var i = ( dir < 0 ? a.length - 1 : 0 ); - i != ( dir < 0 ? dir : a.length ); i += dir ) - fn.apply( obj, [ a[i] ] ); + 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]; @@ -373,681 +696,1643 @@ jQuery.fn = jQuery.prototype = { } return this; - }, + } +}; - end: function() { - this.get( this.stack.pop() ); - 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; + + 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 ); + }; + }); + + 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 ); + }); + }; + }); + + jQuery.each( jQuery.macros.each, function(i,n){ + jQuery.fn[ i ] = function() { + return this.each( n, arguments ); + }; + }); + + 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 ); + }; + }); - find: function(t) { - return this.pushStack( jQuery.map( this, function(a){ - return jQuery.Select(t,a); - }), arguments ); - }, + 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 ); + }; + }); - filter: function(t) { - return t.constructor == Array ? - // Multi Filtering - this.pushStack( jQuery.map(this,function(a){ - for ( var i = 0; i < t.length; i++ ) - if ( jQuery.filter(t[i],[a]).r.length ) - return a; - }), arguments ) : - - this.pushStack( jQuery.filter(t,this).r, arguments ); }, - not: function(t) { - return this.pushStack( t.constructor == String ? - jQuery.filter(t,this,false).r : - jQuery.grep(this,function(a){ return a != t; }), arguments ); + + /** + * 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; }, - add: function(t) { - return this.pushStack( jQuery.merge( this, t.constructor == String ? - jQuery.Select(t) : t.constructor == Array ? t : [t] ), arguments ); + + className: { + add: function(o,c){ + if (jQuery.className.has(o,c)) return; + o.className += ( o.className ? " " : "" ) + c; + }, + remove: function(o,c){ + o.className = !c ? "" : + o.className.replace( + new RegExp("(^|\\s*\\b[^-])"+c+"($|\\b(?=[^-]))", "g"), ""); + }, + has: function(e,a) { + if ( e.className ) + e = e.className; + return new RegExp("(^|\\s)" + a + "(\\s|$)").test(e); + } }, /** - * 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 + * Swap in/out style options. + * @private */ - is: function(expr) { - return jQuery.filter(expr,this).r.length > 0; - } -}; - -(function(){ - var b = navigator.userAgent.toLowerCase(); - - // Figure out what browser is being used - jQuery.browser = - ( /webkit/.test(b) && "safari" ) || - ( /opera/.test(b) && "opera" ) || - ( /msie/.test(b) && "msie" ) || - ( !/compatible/.test(b) && "mozilla" ) || - "other"; - - // Check to see if the W3C box model is being used - jQuery.boxModel = ( jQuery.browser != "msie" || document.compatMode == "CSS1Compat" ); - - var axis = { - parent: "a.parentNode", - parents: jQuery.parents, - ancestors: jQuery.parents, - next: "a.nextSibling", - prev: "a.previousSibling", - siblings: jQuery.sibling - }; + 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; + } - for ( var i in axis ) {(function(){ - var t = axis[i]; - jQuery.fn[ i ] = function(a) { - var ret = jQuery.map(this,t); - if ( a ) ret = jQuery.filter(a,ret).r; - return this.pushStack( ret, arguments ); - }; - })();} - - var to = "html,append,prepend,before,after".split(','); - - for ( var i = 0; i < to.length; i++ ) {(function(){ - var n = to[i]; - jQuery.fn[ n + "To" ] = function(){ - var a = arguments; - return this.each(function(){ - for ( var i = 0; i < a.length; i++ ) - $(a[i])[n]( this ); + jQuery.swap( e, old, function() { + if (jQuery.css(e,"display") != "none") { + oHeight = e.offsetHeight; + oWidth = e.offsetWidth; + } else + jQuery.swap( e, { visibility: "hidden", position: "absolute", display: "" }, + function(){ + oHeight = e.clientHeight; + oWidth = e.clientWidth; + }); }); - }; - })();} - var each = { - show: function(){ - this.style.display = this.oldblock ? this.oldblock : ""; - if ( jQuery.css(this,"display") == "none" ) - this.style.display = "block"; - }, - - hide: function(){ - this.oldblock = jQuery.css(this,"display"); - if ( this.oldblock == "none" ) - this.oldblock = "block"; - this.style.display = "none"; - }, - - toggle: function(){ - var d = jQuery.css(this,"display"); - $(this)[ !d || d == "none" ? 'show' : 'hide' ](); - }, - - addClass: function(c){ - jQuery.className.add(this,c); - }, - - removeClass: function(c){ - jQuery.className.remove(this,c); - }, + 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; - toggleClass: function( c ){ - jQuery.className[ jQuery.hasWord(this,a) ? 'remove' : 'add' ](this,c); - }, + 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; + } - remove: function(){ - this.parentNode.removeChild( this ); - }, + return r; + }, - empty: function(){ - while ( this.firstChild ) - this.removeChild( this.firstChild ); + 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" }, - guid: 1, - global: {}, + /** + * 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. + */ - // Detach an event or set of events from an element - remove: function(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 j in element.events ) - this.remove( element, j ); + /** + * 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(","), + + 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 + */ + + /** + * 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 + */ + + /** + * 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, - // Trigger the event - element["on" + type].apply( element, data ); - } + /** + * 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", + + /** + * 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 + */ + + /** + * 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" }, - - handle: function(event) { - // Handle adding events to items in IFrames, in IE - event = event || - jQuery.event.fix( ((this.ownerDocument || this.document || - this).parentWindow || window).event ); - // If no correct event was found, fail - if ( !event ) return; - - var returnValue = true, handlers = []; - - for ( var j in this.events[event.type] ) - handlers[handlers.length] = this.events[event.type][j]; + 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); + }, - for ( var i = 0; i < handlers.length; i++ ) - if ( handlers[i].constructor == Function ) { - this.handleEvent = handlers[i]; - if (this.handleEvent(event) === false) { - event.preventDefault(); - event.stopPropagation(); - returnValue = false; - } - } - return returnValue; - }, + /** + * 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 ); + }, - fix: function(event) { - if ( event ) { - event.preventDefault = function() { - this.returnValue = false; - }; + /** + * 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 ); + }, - event.stopPropagation = function() { - this.cancelBubble = true; - }; - } + /** + * 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 ); + }, - return event; + /** + * 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 ); + } } - -}; \ No newline at end of file +};