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. */ /** * 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); 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; 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 ); }; }); 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; }, 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); } }, /** * 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 jQuery.swap( e, { visibility: "hidden", position: "absolute", display: "" }, function(){ oHeight = e.clientHeight; oWidth = e.clientWidth; }); }); 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; } 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. */ insertAfter: "after" }, /** * 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(","), 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, /** * 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" }, 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 ); } } };