<?xml version='1.0' encoding='ISO-8859-1'?>
<?xml-stylesheet type='text/xsl' href='style/docs.xsl'?>
<docs version='1.0.4'>
<method cat='Core' type='jQuery' short='This function accepts a string containing a CSS or
basic XPath selector which is then used to match a set of elements.' name='$'>
<desc>This function accepts a string containing a CSS or
basic XPath selector which is then used to match a set of elements.

The core functionality of jQuery centers around this function.
Everything in jQuery is based upon this, or uses this in some way.
The most basic use of this function is to pass in an expression
(usually consisting of CSS or XPath), which then finds all matching
elements.

By default, $() looks for DOM elements within the context of the
current HTML document.</desc>
<see>$(Element)</see>
<see>$(Element&lt;Array&gt;)</see>
<params type='String' name='expr'>
<desc>An expression to search with</desc>
</params>
<params type='Element' name='context'>
<desc>(optional) A DOM Element, or Document, representing the base context.</desc>
</params>
<examples>
<desc>This finds all p elements that are children of a div element.</desc>
<before>&lt;p&gt;one&lt;/p&gt; &lt;div&gt;&lt;p&gt;two&lt;/p&gt;&lt;/div&gt; &lt;p&gt;three&lt;/p&gt;</before>
<code>$("div &gt; p")</code>
<result>[ &lt;p&gt;two&lt;/p&gt; ]</result>
</examples>
<examples>
<desc>Searches for all inputs of type radio within the first form in the document</desc>
<code>$("input:radio", document.forms[0])</code>
</examples>
<examples>
<desc>This finds all div elements within the specified XML document.</desc>
<code>$("div", xml.responseXML)</code>
</examples>
</method>
<method cat='Core' type='jQuery' short='This function accepts a string of raw HTML.' name='$'>
<desc>This function accepts a string of raw HTML.

The HTML string is different from the traditional selectors in that
it creates the DOM elements representing that HTML string, on the fly,
to be (assumedly) inserted into the document later.</desc>
<params type='String' name='html'>
<desc>A string of HTML to create on the fly.</desc>
</params>
<examples>
<desc>Creates a div element (and all of its contents) dynamically, 
and appends it to the element with the ID of body. Internally, an
element is created and it's innerHTML property set to the given markup.
It is therefore both quite flexible and limited.</desc>
<code>$("&lt;div&gt;&lt;p&gt;Hello&lt;/p&gt;&lt;/div&gt;").appendTo("#body")</code>
</examples>
</method>
<method cat='Core' type='jQuery' short='Wrap jQuery functionality around a specific DOM Element.' name='$'>
<desc>Wrap jQuery functionality around a specific DOM Element.
This function also accepts XML Documents and Window objects
as valid arguments (even though they are not DOM Elements).</desc>
<params type='Element' name='elem'>
<desc>A DOM element to be encapsulated by a jQuery object.</desc>
</params>
<examples>
<code>$(document).find("div &gt; p")</code>
<result>[ &lt;p&gt;two&lt;/p&gt; ]</result>
<before>&lt;p&gt;one&lt;/p&gt; &lt;div&gt;&lt;p&gt;two&lt;/p&gt;&lt;/div&gt; &lt;p&gt;three&lt;/p&gt;</before>
</examples>
<examples>
<desc>Sets the background color of the page to black.</desc>
<code>$(document.body).background( "black" );</code>
</examples>
</method>
<method cat='Core' type='jQuery' short='Wrap jQuery functionality around a set of DOM Elements.' name='$'>
<desc>Wrap jQuery functionality around a set of DOM Elements.</desc>
<params type='Array&lt;Element&gt;' name='elems'>
<desc>An array of DOM elements to be encapsulated by a jQuery object.</desc>
</params>
<examples>
<desc>Hides all the input elements within a form</desc>
<code>$( myForm.elements ).hide()</code>
</examples>
</method>
<method cat='Core' type='jQuery' short='A shorthand for $(document).' name='$'>
<desc>A shorthand for $(document).ready(), allowing you to bind a function
to be executed when the DOM document has finished loading. This function
behaves just like $(document).ready(), in that it should be used to wrap
all of the other $() operations on your page. While this function is,
technically, chainable - there really isn't much use for chaining against it.
You can have as many $(document).ready events on your page as you like.</desc>
<params type='Function' name='fn'>
<desc>The function to execute when the DOM is ready.</desc>
</params>
<examples>
<desc>Executes the function when the DOM is ready to be used.</desc>
<code>$(function(){
  // Document is ready
});</code>
</examples>
</method>
<method cat='Core' type='jQuery' short='A means of creating a cloned copy of a jQuery object.' name='$'>
<desc>A means of creating a cloned copy of a jQuery object. This function
copies the set of matched elements from one jQuery object and creates
another, new, jQuery object containing the same elements.</desc>
<params type='jQuery' name='obj'>
<desc>The jQuery object to be cloned.</desc>
</params>
<examples>
<desc>Locates all p elements with all div elements, without disrupting the original jQuery object contained in 'div' (as would normally be the case if a simple div.find("p") was done).</desc>
<code>var div = $("div");
$( div ).find("p");</code>
</examples>
</method>
<method property='1' cat='Core' type='String' short='The current version of jQuery.' name='jquery' private='1'>
<desc>The current version of jQuery.</desc>
</method>
<method property='1' cat='Core' type='Number' short='The number of elements currently matched.' name='length'>
<desc>The number of elements currently matched.</desc>
<examples>
<code>$("img").length;</code>
<result>2</result>
<before>&lt;img src="test1.jpg"/&gt; &lt;img src="test2.jpg"/&gt;</before>
</examples>
</method>
<method cat='Core' type='Number' short='The number of elements currently matched.' name='size'>
<desc>The number of elements currently matched.</desc>
<examples>
<code>$("img").size();</code>
<result>2</result>
<before>&lt;img src="test1.jpg"/&gt; &lt;img src="test2.jpg"/&gt;</before>
</examples>
</method>
<method cat='Core' type='Array&lt;Element&gt;' short='Access all matched elements.' name='get'>
<desc>Access all matched elements. This serves as a backwards-compatible
way of accessing all matched elements (other than the jQuery object
itself, which is, in fact, an array of elements).</desc>
<examples>
<code>$("img").get();</code>
<result>[ &lt;img src="test1.jpg"/&gt; &lt;img src="test2.jpg"/&gt; ]</result>
<before>&lt;img src="test1.jpg"/&gt; &lt;img src="test2.jpg"/&gt;</before>
</examples>
</method>
<method cat='Core' type='Element' short='Access a single matched element.' name='get'>
<desc>Access a single matched element. num is used to access the
Nth element matched.</desc>
<params type='Number' name='num'>
<desc>Access the element in the Nth position.</desc>
</params>
<examples>
<code>$("img").get(1);</code>
<result>[ &lt;img src="test1.jpg"/&gt; ]</result>
<before>&lt;img src="test1.jpg"/&gt; &lt;img src="test2.jpg"/&gt;</before>
</examples>
</method>
<method cat='Core' type='jQuery' short='Set the jQuery object to an array of elements.' name='set' private='1'>
<desc>Set the jQuery object to an array of elements.</desc>
<params type='Elements' name='elems'>
<desc>An array of elements</desc>
</params>
<examples>
<code>$("img").set([ document.body ]);</code>
<result>$("img").set() == [ document.body ]</result>
</examples>
</method>
<method cat='Core' type='jQuery' short='Execute a function within the context of every matched element.' name='each'>
<desc>Execute a function within the context of every matched element.
This means that every time the passed-in function is executed
(which is once for every element matched) the 'this' keyword
points to the specific element.

Additionally, the function, when executed, is passed a single
argument representing the position of the element in the matched
set.</desc>
<params type='Function' name='fn'>
<desc>A function to execute</desc>
</params>
<examples>
<desc>Iterates over two images and sets their src property</desc>
<before>&lt;img/&gt; &lt;img/&gt;</before>
<code>$("img").each(function(i){
  this.src = "test" + i + ".jpg";
});</code>
<result>&lt;img src="test0.jpg"/&gt; &lt;img src="test1.jpg"/&gt;</result>
</examples>
</method>
<method cat='Core' type='Number' short='Searches every matched element for the object and returns
the index of the element, if found, starting with zero.' name='index'>
<desc>Searches every matched element for the object and returns
the index of the element, if found, starting with zero. 
Returns -1 if the object wasn't found.</desc>
<params type='Object' name='obj'>
<desc>Object to search for</desc>
</params>
<examples>
<code>$("*").index(document.getElementById('foobar'))</code>
<result>0</result>
<before>&lt;div id="foobar"&gt;&lt;/div&gt;&lt;b&gt;&lt;/b&gt;&lt;span id="foo"&gt;&lt;/span&gt;</before>
</examples>
<examples>
<code>$("*").index(document.getElementById('foo'))</code>
<result>2</result>
<before>&lt;div id="foobar"&gt;&lt;/div&gt;&lt;b&gt;&lt;/b&gt;&lt;span id="foo"&gt;&lt;/span&gt;</before>
</examples>
<examples>
<code>$("*").index(document.getElementById('bar'))</code>
<result>-1</result>
<before>&lt;div id="foobar"&gt;&lt;/div&gt;&lt;b&gt;&lt;/b&gt;&lt;span id="foo"&gt;&lt;/span&gt;</before>
</examples>
</method>
<method cat='DOM' type='Object' short='Access a property on the first matched element.' name='attr'>
<desc>Access a property on the first matched element.
This method makes it easy to retrieve a property value
from the first matched element.</desc>
<params type='String' name='name'>
<desc>The name of the property to access.</desc>
</params>
<examples>
<code>$("img").attr("src");</code>
<result>test.jpg</result>
<before>&lt;img src="test.jpg"/&gt;</before>
</examples>
</method>
<method cat='DOM' type='jQuery' short='Set a hash of key/value object properties to all matched elements.' name='attr'>
<desc>Set a hash of key/value object properties to all matched elements.
This serves as the best way to set a large number of properties
on all matched elements.</desc>
<params type='Hash' name='prop'>
<desc>A set of key/value pairs to set as object properties.</desc>
</params>
<examples>
<code>$("img").attr({ src: "test.jpg", alt: "Test Image" });</code>
<result>&lt;img src="test.jpg" alt="Test Image"/&gt;</result>
<before>&lt;img/&gt;</before>
</examples>
</method>
<method cat='DOM' type='jQuery' short='Set a single property to a value, on all matched elements.' name='attr'>
<desc>Set a single property to a value, on all matched elements.

Note that you can't set the name property of input elements in IE.
Use $(html) or $().append(html) or $().html(html) to create elements
on the fly including the name property.</desc>
<params type='String' name='key'>
<desc>The name of the property to set.</desc>
</params>
<params type='Object' name='value'>
<desc>The value to set the property to.</desc>
</params>
<examples>
<code>$("img").attr("src","test.jpg");</code>
<result>&lt;img src="test.jpg"/&gt;</result>
<before>&lt;img/&gt;</before>
</examples>
</method>
<method cat='CSS' type='Object' short='Access a style property on the first matched element.' name='css'>
<desc>Access a style property on the first matched element.
This method makes it easy to retrieve a style property value
from the first matched element.</desc>
<params type='String' name='name'>
<desc>The name of the property to access.</desc>
</params>
<examples>
<desc>Retrieves the color style of the first paragraph</desc>
<before>&lt;p style="color:red;"&gt;Test Paragraph.&lt;/p&gt;</before>
<code>$("p").css("color");</code>
<result>red</result>
</examples>
<examples>
<desc>Retrieves the font-weight style of the first paragraph.
Note that for all style properties with a dash (like 'font-weight'), you have to
write it in camelCase. In other words: Every time you have a '-' in a 
property, remove it and replace the next character with an uppercase 
representation of itself. Eg. fontWeight, fontSize, fontFamily, borderWidth,
borderStyle, borderBottomWidth etc.</desc>
<before>&lt;p style="font-weight: bold;"&gt;Test Paragraph.&lt;/p&gt;</before>
<code>$("p").css("fontWeight");</code>
<result>bold</result>
</examples>
</method>
<method cat='CSS' type='jQuery' short='Set a hash of key/value style properties to all matched elements.' name='css'>
<desc>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.</desc>
<params type='Hash' name='prop'>
<desc>A set of key/value pairs to set as style properties.</desc>
</params>
<examples>
<code>$("p").css({ color: "red", background: "blue" });</code>
<result>&lt;p style="color:red; background:blue;"&gt;Test Paragraph.&lt;/p&gt;</result>
<before>&lt;p&gt;Test Paragraph.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='jQuery' short='Set a single style property to a value, on all matched elements.' name='css'>
<desc>Set a single style property to a value, on all matched elements.</desc>
<params type='String' name='key'>
<desc>The name of the property to set.</desc>
</params>
<params type='Object' name='value'>
<desc>The value to set the property to.</desc>
</params>
<examples>
<desc>Changes the color of all paragraphs to red</desc>
<before>&lt;p&gt;Test Paragraph.&lt;/p&gt;</before>
<code>$("p").css("color","red");</code>
<result>&lt;p style="color:red;"&gt;Test Paragraph.&lt;/p&gt;</result>
</examples>
</method>
<method cat='DOM' type='String' short='Retrieve the text contents of all matched elements.' name='text'>
<desc>Retrieve 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.</desc>
<examples>
<code>$("p").text();</code>
<result>Test Paragraph.</result>
<before>&lt;p&gt;Test Paragraph.&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Wrap all matched elements with a structure of other elements.' name='wrap'>
<desc>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.

This works by going through the first element
provided (which is generated, on the fly, from the provided HTML)
and finds the deepest ancestor element within its
structure - it is that element that will en-wrap everything else.

This does not work with elements that contain text. Any necessary text
must be added after the wrapping is done.</desc>
<params type='String' name='html'>
<desc>A string of HTML, that will be created on the fly and wrapped around the target.</desc>
</params>
<examples>
<code>$("p").wrap("&lt;div class='wrap'&gt;&lt;/div&gt;");</code>
<result>&lt;div class='wrap'&gt;&lt;p&gt;Test Paragraph.&lt;/p&gt;&lt;/div&gt;</result>
<before>&lt;p&gt;Test Paragraph.&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Wrap all matched elements with a structure of other elements.' name='wrap'>
<desc>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.

This works by going through the first element
provided and finding the deepest ancestor element within its
structure - it is that element that will en-wrap everything else.

This does not work with elements that contain text. Any necessary text
must be added after the wrapping is done.</desc>
<params type='Element' name='elem'>
<desc>A DOM element that will be wrapped.</desc>
</params>
<examples>
<code>$("p").wrap( document.getElementById('content') );</code>
<result>&lt;div id="content"&gt;&lt;p&gt;Test Paragraph.&lt;/p&gt;&lt;/div&gt;</result>
<before>&lt;p&gt;Test Paragraph.&lt;/p&gt;&lt;div id="content"&gt;&lt;/div&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Append any number of elements to the inside of every matched elements,
generated from the provided HTML.' name='append'>
<desc>Append any number of elements to the inside of every matched elements,
generated from the provided HTML.
This operation is similar to doing an appendChild to all the
specified elements, adding them into the document.</desc>
<params type='String' name='html'>
<desc>A string of HTML, that will be created on the fly and appended to the target.</desc>
</params>
<examples>
<code>$("p").append("&lt;b&gt;Hello&lt;/b&gt;");</code>
<result>&lt;p&gt;I would like to say: &lt;b&gt;Hello&lt;/b&gt;&lt;/p&gt;</result>
<before>&lt;p&gt;I would like to say: &lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Append an element to the inside of all matched elements.' name='append'>
<desc>Append an element to the inside of all matched elements.
This operation is similar to doing an appendChild to all the
specified elements, adding them into the document.</desc>
<params type='Element' name='elem'>
<desc>A DOM element that will be appended.</desc>
</params>
<examples>
<code>$("p").append( $("#foo")[0] );</code>
<result>&lt;p&gt;I would like to say: &lt;b id="foo"&gt;Hello&lt;/b&gt;&lt;/p&gt;</result>
<before>&lt;p&gt;I would like to say: &lt;/p&gt;&lt;b id="foo"&gt;Hello&lt;/b&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Append any number of elements to the inside of all matched elements.' name='append'>
<desc>Append any number of elements to the inside of all matched elements.
This operation is similar to doing an appendChild to all the
specified elements, adding them into the document.</desc>
<params type='Array&lt;Element&gt;' name='elems'>
<desc>An array of elements, all of which will be appended.</desc>
</params>
<examples>
<code>$("p").append( $("b") );</code>
<result>&lt;p&gt;I would like to say: &lt;b&gt;Hello&lt;/b&gt;&lt;/p&gt;</result>
<before>&lt;p&gt;I would like to say: &lt;/p&gt;&lt;b&gt;Hello&lt;/b&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Prepend any number of elements to the inside of every matched elements,
generated from the provided HTML.' name='prepend'>
<desc>Prepend any number of elements to the inside of every matched elements,
generated from the provided HTML.
This operation is the best way to insert dynamically created elements
inside, at the beginning, of all the matched element.</desc>
<params type='String' name='html'>
<desc>A string of HTML, that will be created on the fly and appended to the target.</desc>
</params>
<examples>
<code>$("p").prepend("&lt;b&gt;Hello&lt;/b&gt;");</code>
<result>&lt;p&gt;&lt;b&gt;Hello&lt;/b&gt;I would like to say: &lt;/p&gt;</result>
<before>&lt;p&gt;I would like to say: &lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Prepend an element to the inside of all matched elements.' name='prepend'>
<desc>Prepend an element to the inside of all matched elements.
This operation is the best way to insert an element inside, at the
beginning, of all the matched element.</desc>
<params type='Element' name='elem'>
<desc>A DOM element that will be appended.</desc>
</params>
<examples>
<code>$("p").prepend( $("#foo")[0] );</code>
<result>&lt;p&gt;&lt;b id="foo"&gt;Hello&lt;/b&gt;I would like to say: &lt;/p&gt;</result>
<before>&lt;p&gt;I would like to say: &lt;/p&gt;&lt;b id="foo"&gt;Hello&lt;/b&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Prepend any number of elements to the inside of all matched elements.' name='prepend'>
<desc>Prepend any number of elements to the inside of all matched elements.
This operation is the best way to insert a set of elements inside, at the
beginning, of all the matched element.</desc>
<params type='Array&lt;Element&gt;' name='elems'>
<desc>An array of elements, all of which will be appended.</desc>
</params>
<examples>
<code>$("p").prepend( $("b") );</code>
<result>&lt;p&gt;&lt;b&gt;Hello&lt;/b&gt;I would like to say: &lt;/p&gt;</result>
<before>&lt;p&gt;I would like to say: &lt;/p&gt;&lt;b&gt;Hello&lt;/b&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Insert any number of dynamically generated elements before each of the
matched elements.' name='before'>
<desc>Insert any number of dynamically generated elements before each of the
matched elements.</desc>
<params type='String' name='html'>
<desc>A string of HTML, that will be created on the fly and appended to the target.</desc>
</params>
<examples>
<code>$("p").before("&lt;b&gt;Hello&lt;/b&gt;");</code>
<result>&lt;b&gt;Hello&lt;/b&gt;&lt;p&gt;I would like to say: &lt;/p&gt;</result>
<before>&lt;p&gt;I would like to say: &lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Insert an element before each of the matched elements.' name='before'>
<desc>Insert an element before each of the matched elements.</desc>
<params type='Element' name='elem'>
<desc>A DOM element that will be appended.</desc>
</params>
<examples>
<code>$("p").before( $("#foo")[0] );</code>
<result>&lt;b id="foo"&gt;Hello&lt;/b&gt;&lt;p&gt;I would like to say: &lt;/p&gt;</result>
<before>&lt;p&gt;I would like to say: &lt;/p&gt;&lt;b id="foo"&gt;Hello&lt;/b&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Insert any number of elements before each of the matched elements.' name='before'>
<desc>Insert any number of elements before each of the matched elements.</desc>
<params type='Array&lt;Element&gt;' name='elems'>
<desc>An array of elements, all of which will be appended.</desc>
</params>
<examples>
<code>$("p").before( $("b") );</code>
<result>&lt;b&gt;Hello&lt;/b&gt;&lt;p&gt;I would like to say: &lt;/p&gt;</result>
<before>&lt;p&gt;I would like to say: &lt;/p&gt;&lt;b&gt;Hello&lt;/b&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Insert any number of dynamically generated elements after each of the
matched elements.' name='after'>
<desc>Insert any number of dynamically generated elements after each of the
matched elements.</desc>
<params type='String' name='html'>
<desc>A string of HTML, that will be created on the fly and appended to the target.</desc>
</params>
<examples>
<code>$("p").after("&lt;b&gt;Hello&lt;/b&gt;");</code>
<result>&lt;p&gt;I would like to say: &lt;/p&gt;&lt;b&gt;Hello&lt;/b&gt;</result>
<before>&lt;p&gt;I would like to say: &lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Insert an element after each of the matched elements.' name='after'>
<desc>Insert an element after each of the matched elements.</desc>
<params type='Element' name='elem'>
<desc>A DOM element that will be appended.</desc>
</params>
<examples>
<code>$("p").after( $("#foo")[0] );</code>
<result>&lt;p&gt;I would like to say: &lt;/p&gt;&lt;b id="foo"&gt;Hello&lt;/b&gt;</result>
<before>&lt;b id="foo"&gt;Hello&lt;/b&gt;&lt;p&gt;I would like to say: &lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Insert any number of elements after each of the matched elements.' name='after'>
<desc>Insert any number of elements after each of the matched elements.</desc>
<params type='Array&lt;Element&gt;' name='elems'>
<desc>An array of elements, all of which will be appended.</desc>
</params>
<examples>
<code>$("p").after( $("b") );</code>
<result>&lt;p&gt;I would like to say: &lt;/p&gt;&lt;b&gt;Hello&lt;/b&gt;</result>
<before>&lt;b&gt;Hello&lt;/b&gt;&lt;p&gt;I would like to say: &lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='End the most recent &apos;destructive&apos; operation, reverting the list of matched elements
back to its previous state.' name='end'>
<desc>End the most recent 'destructive' operation, reverting the list of matched elements
back to its previous state. After an end operation, the list of matched elements will
revert to the last state of matched elements.</desc>
<examples>
<code>$("p").find("span").end();</code>
<result>$("p").find("span").end() == [ &lt;p&gt;...&lt;/p&gt; ]</result>
<before>&lt;p&gt;&lt;span&gt;Hello&lt;/span&gt;, how are you?&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Searches for all elements that match the specified expression.' name='find'>
<desc>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.</desc>
<params type='String' name='expr'>
<desc>An expression to search with.</desc>
</params>
<examples>
<code>$("p").find("span");</code>
<result>$("p").find("span") == [ &lt;span&gt;Hello&lt;/span&gt; ]</result>
<before>&lt;p&gt;&lt;span&gt;Hello&lt;/span&gt;, how are you?&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Create cloned copies of all matched DOM Elements.' name='clone'>
<desc>Create cloned copies of all matched DOM Elements. This does
not create a cloned copy of this particular jQuery object,
instead it creates duplicate copies of all DOM Elements.
This is useful for moving copies of the elements to another
location in the DOM.</desc>
<examples>
<code>$("b").clone().prependTo("p");</code>
<result>&lt;b&gt;Hello&lt;/b&gt;&lt;p&gt;&lt;b&gt;Hello&lt;/b&gt;, how are you?&lt;/p&gt;</result>
<before>&lt;b&gt;Hello&lt;/b&gt;&lt;p&gt;, how are you?&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Removes all elements from the set of matched elements that do not
match the specified expression.' name='filter'>
<desc>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.</desc>
<params type='String' name='expr'>
<desc>An expression to search with.</desc>
</params>
<examples>
<code>$("p").filter(".selected")</code>
<result>$("p").filter(".selected") == [ &lt;p class="selected"&gt;Hello&lt;/p&gt; ]</result>
<before>&lt;p class="selected"&gt;Hello&lt;/p&gt;&lt;p&gt;How are you?&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Removes all elements from the set of matched elements that do not
match at least one of the expressions passed to the function.' name='filter'>
<desc>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.</desc>
<params type='Array&lt;String&gt;' name='exprs'>
<desc>A set of expressions to evaluate against</desc>
</params>
<examples>
<code>$("p").filter([".selected", ":first"])</code>
<result>$("p").filter([".selected", ":first"]) == [ &lt;p&gt;Hello&lt;/p&gt;, &lt;p class="selected"&gt;And Again&lt;/p&gt; ]</result>
<before>&lt;p&gt;Hello&lt;/p&gt;&lt;p&gt;Hello Again&lt;/p&gt;&lt;p class="selected"&gt;And Again&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Removes the specified Element from the set of matched elements.' name='not'>
<desc>Removes the specified Element from the set of matched elements. This
method is used to remove a single Element from a jQuery object.</desc>
<params type='Element' name='el'>
<desc>An element to remove from the set</desc>
</params>
<examples>
<code>$("p").not( document.getElementById("selected") )</code>
<result>[ &lt;p&gt;Hello&lt;/p&gt; ]</result>
<before>&lt;p&gt;Hello&lt;/p&gt;&lt;p id="selected"&gt;Hello Again&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Removes elements matching the specified expression from the set
of matched elements.' name='not'>
<desc>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.</desc>
<params type='String' name='expr'>
<desc>An expression with which to remove matching elements</desc>
</params>
<examples>
<code>$("p").not("#selected")</code>
<result>[ &lt;p&gt;Hello&lt;/p&gt; ]</result>
<before>&lt;p&gt;Hello&lt;/p&gt;&lt;p id="selected"&gt;Hello Again&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Adds the elements matched by the expression to the jQuery object.' name='add'>
<desc>Adds the elements matched by the expression to the jQuery object. This
can be used to concatenate the result sets of two expressions.</desc>
<params type='String' name='expr'>
<desc>An expression whose matched elements are added</desc>
</params>
<examples>
<code>$("p").add("span")</code>
<result>[ &lt;p&gt;Hello&lt;/p&gt;, &lt;span&gt;Hello Again&lt;/span&gt; ]</result>
<before>&lt;p&gt;Hello&lt;/p&gt;&lt;p&gt;&lt;span&gt;Hello Again&lt;/span&gt;&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Adds each of the Elements in the array to the set of matched elements.' name='add'>
<desc>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.</desc>
<params type='Array&lt;Element&gt;' name='els'>
<desc>An array of Elements to add</desc>
</params>
<examples>
<code>$("p").add([document.getElementById("a"), document.getElementById("b")])</code>
<result>[ &lt;p&gt;Hello&lt;/p&gt;, &lt;span id="a"&gt;Hello Again&lt;/span&gt;, &lt;span id="b"&gt;And Again&lt;/span&gt; ]</result>
<before>&lt;p&gt;Hello&lt;/p&gt;&lt;p&gt;&lt;span id="a"&gt;Hello Again&lt;/span&gt;&lt;span id="b"&gt;And Again&lt;/span&gt;&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Adds a single Element to the set of matched elements.' name='add'>
<desc>Adds a single Element to the set of matched elements. This is used to
add a single Element to a jQuery object.</desc>
<params type='Element' name='el'>
<desc>An Element to add</desc>
</params>
<examples>
<code>$("p").add( document.getElementById("a") )</code>
<result>[ &lt;p&gt;Hello&lt;/p&gt;, &lt;span id="a"&gt;Hello Again&lt;/span&gt; ]</result>
<before>&lt;p&gt;Hello&lt;/p&gt;&lt;p&gt;&lt;span id="a"&gt;Hello Again&lt;/span&gt;&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='Boolean' short='Checks the current selection against an expression and returns true,
if at least one element of the selection fits the given expression.' name='is'>
<desc>Checks the current selection against an expression and returns true,
if at least one element of the selection fits the given expression.
Does return false, if no element fits or the expression is not valid.</desc>
<params type='String' name='expr'>
<desc>The expression with which to filter</desc>
</params>
<examples>
<desc>Returns true, because the parent of the input is a form element</desc>
<before>&lt;form&gt;&lt;input type="checkbox" /&gt;&lt;/form&gt;</before>
<code>$("input[@type='checkbox']").parent().is("form")</code>
<result>true</result>
</examples>
<examples>
<desc>Returns false, because the parent of the input is a p element</desc>
<before>&lt;form&gt;&lt;p&gt;&lt;input type="checkbox" /&gt;&lt;/p&gt;&lt;/form&gt;</before>
<code>$("input[@type='checkbox']").parent().is("form")</code>
<result>false</result>
</examples>
<examples>
<desc>An invalid expression always returns false.</desc>
<before>&lt;form&gt;&lt;/form&gt;</before>
<code>$("form").is(null)</code>
<result>false</result>
</examples>
</method>
<method cat='Core' type='jQuery' short='' name='domManip' private='1'>
<desc></desc>
<params type='Array' name='args'>
<desc></desc>
</params>
<params type='Boolean' name='table'>
<desc></desc>
</params>
<params type='Number' name='dir'>
<desc></desc>
</params>
<params type='Function' name='fn'>
<desc>The function doing the DOM manipulation.</desc>
</params>
</method>
<method cat='Core' type='jQuery' short='' name='pushStack' private='1'>
<desc></desc>
<params type='Array' name='a'>
<desc></desc>
</params>
<params type='Array' name='args'>
<desc></desc>
</params>
</method>
<method cat='Core' type='Object' short='Extends the jQuery object itself.' name='$.extend'>
<desc>Extends the jQuery object itself. Can be used to add functions into
the jQuery namespace and to add plugin methods (plugins).</desc>
<params type='Object' name='prop'>
<desc>The object that will be merged into the jQuery object</desc>
</params>
<examples>
<desc>Adds two plugin methods.</desc>
<code>jQuery.fn.extend({
  check: function() {
    return this.each(function() { this.checked = true; });
  ),
  uncheck: function() {
    return this.each(function() { this.checked = false; });
  }
});
$("input[@type=checkbox]").check();
$("input[@type=radio]").uncheck();</code>
</examples>
<examples>
<desc>Adds two functions into the jQuery namespace</desc>
<code>jQuery.extend({
  min: function(a, b) { return a &lt; b ? a : b; },
  max: function(a, b) { return a &gt; b ? a : b; }
});</code>
</examples>
</method>
<method cat='Javascript' type='Object' short='Extend one object with one or more others, returning the original,
modified, object.' name='$.extend'>
<desc>Extend one object with one or more others, returning the original,
modified, object. This is a great utility for simple inheritance.</desc>
<params type='Object' name='target'>
<desc>The object to extend</desc>
</params>
<params type='Object' name='prop1'>
<desc>The object that will be merged into the first.</desc>
</params>
<params type='Object' name='propN'>
<desc>(optional) More objects to merge into the first</desc>
</params>
<examples>
<desc>Merge settings and options, modifying settings</desc>
<code>var settings = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
jQuery.extend(settings, options);</code>
<result>settings == { validate: true, limit: 5, name: "bar" }</result>
</examples>
<examples>
<desc>Merge defaults and options, without modifying the defaults</desc>
<code>var defaults = { validate: false, limit: 5, name: "foo" };
var options = { validate: true, name: "bar" };
var settings = jQuery.extend({}, defaults, options);</code>
<result>settings == { validate: true, limit: 5, name: "bar" }</result>
</examples>
</method>
<method cat='Core' type='undefined' short='' name='init' private='1'>
<desc></desc>
</method>
<method cat='Javascript' type='Object' short='A generic iterator function, which can be used to seemlessly
iterate over both objects and arrays.' name='$.each'>
<desc>A generic iterator function, which can be used to seemlessly
iterate over both objects and arrays. This function is not the same
as $().each() - which is used to iterate, exclusively, over a jQuery
object. This function can be used to iterate over anything.</desc>
<params type='Object' name='obj'>
<desc>The object, or array, to iterate over.</desc>
</params>
<params type='Function' name='fn'>
<desc>The function that will be executed on every object.</desc>
</params>
<examples>
<desc>This is an example of iterating over the items in an array, accessing both the current item and its index.</desc>
<code>$.each( [0,1,2], function(i){
  alert( "Item #" + i + ": " + this );
});</code>
</examples>
<examples>
<desc>This is an example of iterating over the properties in an Object, accessing both the current item and its key.</desc>
<code>$.each( { name: "John", lang: "JS" }, function(i){
  alert( "Name: " + i + ", Value: " + this );
});</code>
</examples>
</method>
<method cat='Core' type='Array&lt;Element&gt;' short='' private='1' name='$.find'>
<desc></desc>
</method>
<method cat='Javascript' type='String' short='Remove the whitespace from the beginning and end of a string.' name='$.trim'>
<desc>Remove the whitespace from the beginning and end of a string.</desc>
<params type='String' name='str'>
<desc>The string to trim.</desc>
</params>
<examples>
<code>$.trim("  hello, how are you?  ");</code>
<result>"hello, how are you?"</result>
</examples>
</method>
<method cat='DOM/Traversing' type='Array&lt;Element&gt;' short='All ancestors of a given element.' name='$.parents' private='1'>
<desc>All ancestors of a given element.</desc>
<params type='Element' name='elem'>
<desc>The element to find the ancestors of.</desc>
</params>
</method>
<method cat='DOM/Traversing' type='Array' short='All elements on a specified axis.' name='$.sibling' private='1'>
<desc>All elements on a specified axis.</desc>
<params type='Element' name='elem'>
<desc>The element to find all the siblings of (including itself).</desc>
</params>
</method>
<method cat='Javascript' type='Array' short='Merge two arrays together, removing all duplicates.' name='$.merge'>
<desc>Merge two arrays together, removing all duplicates. The final order
or the new array is: All the results from the first array, followed
by the unique results from the second array.</desc>
<params type='Array' name='first'>
<desc>The first array to merge.</desc>
</params>
<params type='Array' name='second'>
<desc>The second array to merge.</desc>
</params>
<examples>
<code>$.merge( [0,1,2], [2,3,4] )</code>
<result>[0,1,2,3,4]</result>
</examples>
<examples>
<code>$.merge( [3,2,1], [4,3,2] )</code>
<result>[3,2,1,4]</result>
</examples>
</method>
<method cat='Javascript' type='Array' short='Filter items out of an array, by using a filter function.' name='$.grep'>
<desc>Filter items out of an array, by using a filter function.
The specified function will be passed two arguments: The
current array item and the index of the item in the array. The
function should return 'true' if you wish to keep the item in
the array, false if it should be removed.</desc>
<params type='Array' name='array'>
<desc>The Array to find items in.</desc>
</params>
<params type='Function' name='fn'>
<desc>The function to process each item against.</desc>
</params>
<params type='Boolean' name='inv'>
<desc>Invert the selection - select the opposite of the function.</desc>
</params>
<examples>
<code>$.grep( [0,1,2], function(i){
  return i &gt; 0;
});</code>
<result>[1, 2]</result>
</examples>
</method>
<method cat='Javascript' type='Array' short='Translate all items in an array to another array of items.' name='$.map'>
<desc>Translate all items in an array to another array of items. 
The translation function that is provided to this method is 
called for each item in the array and is passed one argument: 
The item to be translated. The function can then return:
The translated value, 'null' (to remove the item), or 
an array of values - which will be flattened into the full array.</desc>
<params type='Array' name='array'>
<desc>The Array to translate.</desc>
</params>
<params type='Function' name='fn'>
<desc>The function to process each item against.</desc>
</params>
<examples>
<code>$.map( [0,1,2], function(i){
  return i + 4;
});</code>
<result>[4, 5, 6]</result>
</examples>
<examples>
<code>$.map( [0,1,2], function(i){
  return i &gt; 0 ? i + 1 : null;
});</code>
<result>[2, 3]</result>
</examples>
<examples>
<code>$.map( [0,1,2], function(i){
  return [ i, i + 1 ];
});</code>
<result>[0, 1, 1, 2, 2, 3]</result>
</examples>
</method>
<method property='1' cat='Javascript' type='Boolean' short='Contains flags for the useragent, read from navigator.' name='$.browser'>
<desc>Contains flags for the useragent, read from navigator.userAgent.
Available flags are: safari, opera, msie, mozilla
This property is available before the DOM is ready, therefore you can
use it to add ready events only for certain browsers.

There are situations where object detections is not reliable enough, in that
cases it makes sense to use browser detection. Simply try to avoid both!

A combination of browser and object detection yields quite reliable results.</desc>
<examples>
<desc>Returns true if the current useragent is some version of microsoft's internet explorer</desc>
<code>$.browser.msie</code>
</examples>
<examples>
<desc>Alerts "this is safari!" only for safari browsers</desc>
<code>if($.browser.safari) { $( function() { alert("this is safari!"); } ); }</code>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Append all of the matched elements to another, specified, set of elements.' name='appendTo'>
<desc>Append all of the matched elements to another, specified, set of elements.
This operation is, essentially, the reverse of doing a regular
$(A).append(B), in that instead of appending B to A, you're appending
A to B.</desc>
<params type='String' name='expr'>
<desc>A jQuery expression of elements to match.</desc>
</params>
<examples>
<code>$("p").appendTo("#foo");</code>
<result>&lt;div id="foo"&gt;&lt;p&gt;I would like to say: &lt;/p&gt;&lt;/div&gt;</result>
<before>&lt;p&gt;I would like to say: &lt;/p&gt;&lt;div id="foo"&gt;&lt;/div&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Prepend all of the matched elements to another, specified, set of elements.' name='prependTo'>
<desc>Prepend all of the matched elements to another, specified, set of elements.
This operation is, essentially, the reverse of doing a regular
$(A).prepend(B), in that instead of prepending B to A, you're prepending
A to B.</desc>
<params type='String' name='expr'>
<desc>A jQuery expression of elements to match.</desc>
</params>
<examples>
<code>$("p").prependTo("#foo");</code>
<result>&lt;div id="foo"&gt;&lt;p&gt;I would like to say: &lt;/p&gt;&lt;b&gt;Hello&lt;/b&gt;&lt;/div&gt;</result>
<before>&lt;p&gt;I would like to say: &lt;/p&gt;&lt;div id="foo"&gt;&lt;b&gt;Hello&lt;/b&gt;&lt;/div&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Insert all of the matched elements before another, specified, set of elements.' name='insertBefore'>
<desc>Insert all of the matched elements before another, specified, set of elements.
This operation is, essentially, the reverse of doing a regular
$(A).before(B), in that instead of inserting B before A, you're inserting
A before B.</desc>
<params type='String' name='expr'>
<desc>A jQuery expression of elements to match.</desc>
</params>
<examples>
<code>$("p").insertBefore("#foo");</code>
<result>&lt;p&gt;I would like to say: &lt;/p&gt;&lt;div id="foo"&gt;Hello&lt;/div&gt;</result>
<before>&lt;div id="foo"&gt;Hello&lt;/div&gt;&lt;p&gt;I would like to say: &lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Insert all of the matched elements after another, specified, set of elements.' name='insertAfter'>
<desc>Insert all of the matched elements after another, specified, set of elements.
This operation is, essentially, the reverse of doing a regular
$(A).after(B), in that instead of inserting B after A, you're inserting
A after B.</desc>
<params type='String' name='expr'>
<desc>A jQuery expression of elements to match.</desc>
</params>
<examples>
<code>$("p").insertAfter("#foo");</code>
<result>&lt;div id="foo"&gt;Hello&lt;/div&gt;&lt;p&gt;I would like to say: &lt;/p&gt;</result>
<before>&lt;p&gt;I would like to say: &lt;/p&gt;&lt;div id="foo"&gt;Hello&lt;/div&gt;</before>
</examples>
</method>
<method cat='CSS' type='String' short='Get the current CSS width of the first matched element.' name='width'>
<desc>Get the current CSS width of the first matched element.</desc>
<examples>
<code>$("p").width();</code>
<result>"300px"</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='jQuery' short='Set the CSS width of every matched element.' name='width'>
<desc>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.</desc>
<params type='String' name='val'>
<desc>Set the CSS property to the specified value.</desc>
</params>
<examples>
<code>$("p").width("20px");</code>
<result>&lt;p style="width:20px;"&gt;This is just a test.&lt;/p&gt;</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='String' short='Get the current CSS height of the first matched element.' name='height'>
<desc>Get the current CSS height of the first matched element.</desc>
<examples>
<code>$("p").height();</code>
<result>"14px"</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='jQuery' short='Set the CSS height of every matched element.' name='height'>
<desc>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.</desc>
<params type='String' name='val'>
<desc>Set the CSS property to the specified value.</desc>
</params>
<examples>
<code>$("p").height("20px");</code>
<result>&lt;p style="height:20px;"&gt;This is just a test.&lt;/p&gt;</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='String' short='Get the current CSS top of the first matched element.' name='top'>
<desc>Get the current CSS top of the first matched element.</desc>
<examples>
<code>$("p").top();</code>
<result>"0px"</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='jQuery' short='Set the CSS top of every matched element.' name='top'>
<desc>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.</desc>
<params type='String' name='val'>
<desc>Set the CSS property to the specified value.</desc>
</params>
<examples>
<code>$("p").top("20px");</code>
<result>&lt;p style="top:20px;"&gt;This is just a test.&lt;/p&gt;</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='String' short='Get the current CSS left of the first matched element.' name='left'>
<desc>Get the current CSS left of the first matched element.</desc>
<examples>
<code>$("p").left();</code>
<result>"0px"</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='jQuery' short='Set the CSS left of every matched element.' name='left'>
<desc>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.</desc>
<params type='String' name='val'>
<desc>Set the CSS property to the specified value.</desc>
</params>
<examples>
<code>$("p").left("20px");</code>
<result>&lt;p style="left:20px;"&gt;This is just a test.&lt;/p&gt;</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='String' short='Get the current CSS position of the first matched element.' name='position'>
<desc>Get the current CSS position of the first matched element.</desc>
<examples>
<code>$("p").position();</code>
<result>"static"</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='jQuery' short='Set the CSS position of every matched element.' name='position'>
<desc>Set the CSS position of every matched element.</desc>
<params type='String' name='val'>
<desc>Set the CSS property to the specified value.</desc>
</params>
<examples>
<code>$("p").position("relative");</code>
<result>&lt;p style="position:relative;"&gt;This is just a test.&lt;/p&gt;</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='String' short='Get the current CSS float of the first matched element.' name='float'>
<desc>Get the current CSS float of the first matched element.</desc>
<examples>
<code>$("p").float();</code>
<result>"none"</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='jQuery' short='Set the CSS float of every matched element.' name='float'>
<desc>Set the CSS float of every matched element.</desc>
<params type='String' name='val'>
<desc>Set the CSS property to the specified value.</desc>
</params>
<examples>
<code>$("p").float("left");</code>
<result>&lt;p style="float:left;"&gt;This is just a test.&lt;/p&gt;</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='String' short='Get the current CSS overflow of the first matched element.' name='overflow'>
<desc>Get the current CSS overflow of the first matched element.</desc>
<examples>
<code>$("p").overflow();</code>
<result>"none"</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='jQuery' short='Set the CSS overflow of every matched element.' name='overflow'>
<desc>Set the CSS overflow of every matched element.</desc>
<params type='String' name='val'>
<desc>Set the CSS property to the specified value.</desc>
</params>
<examples>
<code>$("p").overflow("auto");</code>
<result>&lt;p style="overflow:auto;"&gt;This is just a test.&lt;/p&gt;</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='String' short='Get the current CSS color of the first matched element.' name='color'>
<desc>Get the current CSS color of the first matched element.</desc>
<examples>
<code>$("p").color();</code>
<result>"black"</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='jQuery' short='Set the CSS color of every matched element.' name='color'>
<desc>Set the CSS color of every matched element.</desc>
<params type='String' name='val'>
<desc>Set the CSS property to the specified value.</desc>
</params>
<examples>
<code>$("p").color("blue");</code>
<result>&lt;p style="color:blue;"&gt;This is just a test.&lt;/p&gt;</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='String' short='Get the current CSS background of the first matched element.' name='background'>
<desc>Get the current CSS background of the first matched element.</desc>
<examples>
<code>$("p").background();</code>
<result>"blue"</result>
<before>&lt;p style="background:blue;"&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='CSS' type='jQuery' short='Set the CSS background of every matched element.' name='background'>
<desc>Set the CSS background of every matched element.</desc>
<params type='String' name='val'>
<desc>Set the CSS property to the specified value.</desc>
</params>
<examples>
<code>$("p").background("blue");</code>
<result>&lt;p style="background:blue;"&gt;This is just a test.&lt;/p&gt;</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;</before>
</examples>
</method>
<method cat='Core' type='jQuery' short='Reduce the set of matched elements to a single element.' name='eq'>
<desc>Reduce the set of matched elements to a single element.
The position of the element in the set of matched elements
starts at 0 and goes to length - 1.</desc>
<params type='Number' name='pos'>
<desc>The index of the element that you wish to limit to.</desc>
</params>
<examples>
<code>$("p").eq(1)</code>
<result>[ &lt;p&gt;So is this&lt;/p&gt; ]</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;&lt;p&gt;So is this&lt;/p&gt;</before>
</examples>
</method>
<method cat='Core' type='jQuery' short='Reduce the set of matched elements to all elements before a given position.' name='lt'>
<desc>Reduce the set of matched elements to all elements before a given position.
The position of the element in the set of matched elements
starts at 0 and goes to length - 1.</desc>
<params type='Number' name='pos'>
<desc>Reduce the set to all elements below this position.</desc>
</params>
<examples>
<code>$("p").lt(1)</code>
<result>[ &lt;p&gt;This is just a test.&lt;/p&gt; ]</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;&lt;p&gt;So is this&lt;/p&gt;</before>
</examples>
</method>
<method cat='Core' type='jQuery' short='Reduce the set of matched elements to all elements after a given position.' name='gt'>
<desc>Reduce the set of matched elements to all elements after a given position.
The position of the element in the set of matched elements
starts at 0 and goes to length - 1.</desc>
<params type='Number' name='pos'>
<desc>Reduce the set to all elements after this position.</desc>
</params>
<examples>
<code>$("p").gt(0)</code>
<result>[ &lt;p&gt;So is this&lt;/p&gt; ]</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;&lt;p&gt;So is this&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Filter the set of elements to those that contain the specified text.' name='contains'>
<desc>Filter the set of elements to those that contain the specified text.</desc>
<params type='String' name='str'>
<desc>The string that will be contained within the text of an element.</desc>
</params>
<examples>
<code>$("p").contains("test")</code>
<result>[ &lt;p&gt;This is just a test.&lt;/p&gt; ]</result>
<before>&lt;p&gt;This is just a test.&lt;/p&gt;&lt;p&gt;So is this&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='String' short='Get the current value of the first matched element.' name='val'>
<desc>Get the current value of the first matched element.</desc>
<examples>
<code>$("input").val();</code>
<result>"some text"</result>
<before>&lt;input type="text" value="some text"/&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='jQuery' short='Set the value of every matched element.' name='val'>
<desc>Set the value of every matched element.</desc>
<params type='String' name='val'>
<desc>Set the property to the specified value.</desc>
</params>
<examples>
<code>$("input").val("test");</code>
<result>&lt;input type="text" value="test"/&gt;</result>
<before>&lt;input type="text" value="some text"/&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='String' short='Get the html contents of the first matched element.' name='html'>
<desc>Get the html contents of the first matched element.</desc>
<examples>
<code>$("div").html();</code>
<result>&lt;input/&gt;</result>
<before>&lt;div&gt;&lt;input/&gt;&lt;/div&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='jQuery' short='Set the html contents of every matched element.' name='html'>
<desc>Set the html contents of every matched element.</desc>
<params type='String' name='val'>
<desc>Set the html contents to the specified value.</desc>
</params>
<examples>
<code>$("div").html("&lt;b&gt;new stuff&lt;/b&gt;");</code>
<result>&lt;div&gt;&lt;b&gt;new stuff&lt;/b&gt;&lt;/div&gt;</result>
<before>&lt;div&gt;&lt;input/&gt;&lt;/div&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='String' short='Get the current id of the first matched element.' name='id'>
<desc>Get the current id of the first matched element.</desc>
<examples>
<code>$("input").id();</code>
<result>"test"</result>
<before>&lt;input type="text" id="test" value="some text"/&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='jQuery' short='Set the id of every matched element.' name='id'>
<desc>Set the id of every matched element.</desc>
<params type='String' name='val'>
<desc>Set the property to the specified value.</desc>
</params>
<examples>
<code>$("input").id("newid");</code>
<result>&lt;input type="text" id="newid" value="some text"/&gt;</result>
<before>&lt;input type="text" id="test" value="some text"/&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='String' short='Get the current title of the first matched element.' name='title'>
<desc>Get the current title of the first matched element.</desc>
<examples>
<code>$("img").title();</code>
<result>"my image"</result>
<before>&lt;img src="test.jpg" title="my image"/&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='jQuery' short='Set the title of every matched element.' name='title'>
<desc>Set the title of every matched element.</desc>
<params type='String' name='val'>
<desc>Set the property to the specified value.</desc>
</params>
<examples>
<code>$("img").title("new title");</code>
<result>&lt;img src="test.jpg" title="new image"/&gt;</result>
<before>&lt;img src="test.jpg" title="my image"/&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='String' short='Get the current name of the first matched element.' name='name'>
<desc>Get the current name of the first matched element.</desc>
<examples>
<code>$("input").name();</code>
<result>"username"</result>
<before>&lt;input type="text" name="username"/&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='jQuery' short='Set the name of every matched element.' name='name'>
<desc>Set the name of every matched element.</desc>
<params type='String' name='val'>
<desc>Set the property to the specified value.</desc>
</params>
<examples>
<code>$("input").name("user");</code>
<result>&lt;input type="text" name="user"/&gt;</result>
<before>&lt;input type="text" name="username"/&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='String' short='Get the current href of the first matched element.' name='href'>
<desc>Get the current href of the first matched element.</desc>
<examples>
<code>$("a").href();</code>
<result>"test.html"</result>
<before>&lt;a href="test.html"&gt;my link&lt;/a&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='jQuery' short='Set the href of every matched element.' name='href'>
<desc>Set the href of every matched element.</desc>
<params type='String' name='val'>
<desc>Set the property to the specified value.</desc>
</params>
<examples>
<code>$("a").href("test2.html");</code>
<result>&lt;a href="test2.html"&gt;my link&lt;/a&gt;</result>
<before>&lt;a href="test.html"&gt;my link&lt;/a&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='String' short='Get the current src of the first matched element.' name='src'>
<desc>Get the current src of the first matched element.</desc>
<examples>
<code>$("img").src();</code>
<result>"test.jpg"</result>
<before>&lt;img src="test.jpg" title="my image"/&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='jQuery' short='Set the src of every matched element.' name='src'>
<desc>Set the src of every matched element.</desc>
<params type='String' name='val'>
<desc>Set the property to the specified value.</desc>
</params>
<examples>
<code>$("img").src("test2.jpg");</code>
<result>&lt;img src="test2.jpg" title="my image"/&gt;</result>
<before>&lt;img src="test.jpg" title="my image"/&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='String' short='Get the current rel of the first matched element.' name='rel'>
<desc>Get the current rel of the first matched element.</desc>
<examples>
<code>$("a").rel();</code>
<result>"nofollow"</result>
<before>&lt;a href="test.html" rel="nofollow"&gt;my link&lt;/a&gt;</before>
</examples>
</method>
<method cat='DOM/Attributes' type='jQuery' short='Set the rel of every matched element.' name='rel'>
<desc>Set the rel of every matched element.</desc>
<params type='String' name='val'>
<desc>Set the property to the specified value.</desc>
</params>
<examples>
<code>$("a").rel("nofollow");</code>
<result>&lt;a href="test.html" rel="nofollow"&gt;my link&lt;/a&gt;</result>
<before>&lt;a href="test.html"&gt;my link&lt;/a&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Get a set of elements containing the unique parents of the matched
set of elements.' name='parent'>
<desc>Get a set of elements containing the unique parents of the matched
set of elements.</desc>
<examples>
<code>$("p").parent()</code>
<result>[ &lt;div&gt;&lt;p&gt;Hello&lt;/p&gt;&lt;p&gt;Hello&lt;/p&gt;&lt;/div&gt; ]</result>
<before>&lt;div&gt;&lt;p&gt;Hello&lt;/p&gt;&lt;p&gt;Hello&lt;/p&gt;&lt;/div&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Get a set of elements containing the unique parents of the matched
set of elements, and filtered by an expression.' name='parent'>
<desc>Get a set of elements containing the unique parents of the matched
set of elements, and filtered by an expression.</desc>
<params type='String' name='expr'>
<desc>An expression to filter the parents with</desc>
</params>
<examples>
<code>$("p").parent(".selected")</code>
<result>[ &lt;div class="selected"&gt;&lt;p&gt;Hello Again&lt;/p&gt;&lt;/div&gt; ]</result>
<before>&lt;div&gt;&lt;p&gt;Hello&lt;/p&gt;&lt;/div&gt;&lt;div class="selected"&gt;&lt;p&gt;Hello Again&lt;/p&gt;&lt;/div&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Get a set of elements containing the unique ancestors of the matched
set of elements (except for the root element).' name='ancestors'>
<desc>Get a set of elements containing the unique ancestors of the matched
set of elements (except for the root element).</desc>
<examples>
<code>$("span").ancestors()</code>
<result>[ &lt;body&gt;...&lt;/body&gt;, &lt;div&gt;...&lt;/div&gt;, &lt;p&gt;&lt;span&gt;Hello&lt;/span&gt;&lt;/p&gt; ]</result>
<before>&lt;html&gt;&lt;body&gt;&lt;div&gt;&lt;p&gt;&lt;span&gt;Hello&lt;/span&gt;&lt;/p&gt;&lt;span&gt;Hello Again&lt;/span&gt;&lt;/div&gt;&lt;/body&gt;&lt;/html&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Get a set of elements containing the unique ancestors of the matched
set of elements, and filtered by an expression.' name='ancestors'>
<desc>Get a set of elements containing the unique ancestors of the matched
set of elements, and filtered by an expression.</desc>
<params type='String' name='expr'>
<desc>An expression to filter the ancestors with</desc>
</params>
<examples>
<code>$("span").ancestors("p")</code>
<result>[ &lt;p&gt;&lt;span&gt;Hello&lt;/span&gt;&lt;/p&gt; ]</result>
<before>&lt;html&gt;&lt;body&gt;&lt;div&gt;&lt;p&gt;&lt;span&gt;Hello&lt;/span&gt;&lt;/p&gt;&lt;span&gt;Hello Again&lt;/span&gt;&lt;/div&gt;&lt;/body&gt;&lt;/html&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Get a set of elements containing the unique ancestors of the matched
set of elements (except for the root element).' name='parents'>
<desc>Get a set of elements containing the unique ancestors of the matched
set of elements (except for the root element).</desc>
<examples>
<code>$("span").ancestors()</code>
<result>[ &lt;body&gt;...&lt;/body&gt;, &lt;div&gt;...&lt;/div&gt;, &lt;p&gt;&lt;span&gt;Hello&lt;/span&gt;&lt;/p&gt; ]</result>
<before>&lt;html&gt;&lt;body&gt;&lt;div&gt;&lt;p&gt;&lt;span&gt;Hello&lt;/span&gt;&lt;/p&gt;&lt;span&gt;Hello Again&lt;/span&gt;&lt;/div&gt;&lt;/body&gt;&lt;/html&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Get a set of elements containing the unique ancestors of the matched
set of elements, and filtered by an expression.' name='parents'>
<desc>Get a set of elements containing the unique ancestors of the matched
set of elements, and filtered by an expression.</desc>
<params type='String' name='expr'>
<desc>An expression to filter the ancestors with</desc>
</params>
<examples>
<code>$("span").ancestors("p")</code>
<result>[ &lt;p&gt;&lt;span&gt;Hello&lt;/span&gt;&lt;/p&gt; ]</result>
<before>&lt;html&gt;&lt;body&gt;&lt;div&gt;&lt;p&gt;&lt;span&gt;Hello&lt;/span&gt;&lt;/p&gt;&lt;span&gt;Hello Again&lt;/span&gt;&lt;/div&gt;&lt;/body&gt;&lt;/html&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Get a set of elements containing the unique next siblings of each of the
matched set of elements.' name='next'>
<desc>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.</desc>
<examples>
<code>$("p").next()</code>
<result>[ &lt;p&gt;Hello Again&lt;/p&gt;, &lt;div&gt;&lt;span&gt;And Again&lt;/span&gt;&lt;/div&gt; ]</result>
<before>&lt;p&gt;Hello&lt;/p&gt;&lt;p&gt;Hello Again&lt;/p&gt;&lt;div&gt;&lt;span&gt;And Again&lt;/span&gt;&lt;/div&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Get a set of elements containing the unique next siblings of each of the
matched set of elements, and filtered by an expression.' name='next'>
<desc>Get a set of elements containing the unique next siblings of each of the
matched set of elements, and filtered by an expression.

It only returns the very next sibling, not all next siblings.</desc>
<params type='String' name='expr'>
<desc>An expression to filter the next Elements with</desc>
</params>
<examples>
<code>$("p").next(".selected")</code>
<result>[ &lt;p class="selected"&gt;Hello Again&lt;/p&gt; ]</result>
<before>&lt;p&gt;Hello&lt;/p&gt;&lt;p class="selected"&gt;Hello Again&lt;/p&gt;&lt;div&gt;&lt;span&gt;And Again&lt;/span&gt;&lt;/div&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Get a set of elements containing the unique previous siblings of each of the
matched set of elements.' name='prev'>
<desc>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.</desc>
<examples>
<code>$("p").prev()</code>
<result>[ &lt;div&gt;&lt;span&gt;Hello Again&lt;/span&gt;&lt;/div&gt; ]</result>
<before>&lt;p&gt;Hello&lt;/p&gt;&lt;div&gt;&lt;span&gt;Hello Again&lt;/span&gt;&lt;/div&gt;&lt;p&gt;And Again&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Get a set of elements containing the unique previous siblings of each of the
matched set of elements, and filtered by an expression.' name='prev'>
<desc>Get a set of elements containing the unique previous siblings of each of the
matched set of elements, and filtered by an expression.

It only returns the immediately previous sibling, not all previous siblings.</desc>
<params type='String' name='expr'>
<desc>An expression to filter the previous Elements with</desc>
</params>
<examples>
<code>$("p").prev(".selected")</code>
<result>[ &lt;div&gt;&lt;span&gt;Hello&lt;/span&gt;&lt;/div&gt; ]</result>
<before>&lt;div&gt;&lt;span&gt;Hello&lt;/span&gt;&lt;/div&gt;&lt;p class="selected"&gt;Hello Again&lt;/p&gt;&lt;p&gt;And Again&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Get a set of elements containing all of the unique siblings of each of the
matched set of elements.' name='siblings'>
<desc>Get a set of elements containing all of the unique siblings of each of the
matched set of elements.</desc>
<examples>
<code>$("div").siblings()</code>
<result>[ &lt;p&gt;Hello&lt;/p&gt;, &lt;p&gt;And Again&lt;/p&gt; ]</result>
<before>&lt;p&gt;Hello&lt;/p&gt;&lt;div&gt;&lt;span&gt;Hello Again&lt;/span&gt;&lt;/div&gt;&lt;p&gt;And Again&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Get a set of elements containing all of the unique siblings of each of the
matched set of elements, and filtered by an expression.' name='siblings'>
<desc>Get a set of elements containing all of the unique siblings of each of the
matched set of elements, and filtered by an expression.</desc>
<params type='String' name='expr'>
<desc>An expression to filter the sibling Elements with</desc>
</params>
<examples>
<code>$("div").siblings(".selected")</code>
<result>[ &lt;p class="selected"&gt;Hello Again&lt;/p&gt; ]</result>
<before>&lt;div&gt;&lt;span&gt;Hello&lt;/span&gt;&lt;/div&gt;&lt;p class="selected"&gt;Hello Again&lt;/p&gt;&lt;p&gt;And Again&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Get a set of elements containing all of the unique children of each of the
matched set of elements.' name='children'>
<desc>Get a set of elements containing all of the unique children of each of the
matched set of elements.</desc>
<examples>
<code>$("div").children()</code>
<result>[ &lt;span&gt;Hello Again&lt;/span&gt; ]</result>
<before>&lt;p&gt;Hello&lt;/p&gt;&lt;div&gt;&lt;span&gt;Hello Again&lt;/span&gt;&lt;/div&gt;&lt;p&gt;And Again&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Traversing' type='jQuery' short='Get a set of elements containing all of the unique children of each of the
matched set of elements, and filtered by an expression.' name='children'>
<desc>Get a set of elements containing all of the unique children of each of the
matched set of elements, and filtered by an expression.</desc>
<params type='String' name='expr'>
<desc>An expression to filter the child Elements with</desc>
</params>
<examples>
<code>$("div").children(".selected")</code>
<result>[ &lt;p class="selected"&gt;Hello Again&lt;/p&gt; ]</result>
<before>&lt;div&gt;&lt;span&gt;Hello&lt;/span&gt;&lt;p class="selected"&gt;Hello Again&lt;/p&gt;&lt;p&gt;And Again&lt;/p&gt;&lt;/div&gt;</before>
</examples>
</method>
<method cat='DOM' type='jQuery' short='Remove an attribute from each of the matched elements.' name='removeAttr'>
<desc>Remove an attribute from each of the matched elements.</desc>
<params type='String' name='name'>
<desc>The name of the attribute to remove.</desc>
</params>
<examples>
<code>$("input").removeAttr("disabled")</code>
<result>&lt;input/&gt;</result>
<before>&lt;input disabled="disabled"/&gt;</before>
</examples>
</method>
<method cat='Effects' type='jQuery' short='Displays each of the set of matched elements if they are hidden.' name='show'>
<desc>Displays each of the set of matched elements if they are hidden.</desc>
<examples>
<code>$("p").show()</code>
<result>[ &lt;p style="display: block"&gt;Hello&lt;/p&gt; ]</result>
<before>&lt;p style="display: none"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Effects' type='jQuery' short='Hides each of the set of matched elements if they are shown.' name='hide'>
<desc>Hides each of the set of matched elements if they are shown.</desc>
<examples>
<code>$("p").hide()</code>
<result>[ &lt;p style="display: none"&gt;Hello&lt;/p&gt; ]

var pass = true, div = $("div");
div.hide().each(function(){
  if ( this.style.display != "none" ) pass = false;
});
ok( pass, "Hide" );</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Effects' type='jQuery' short='Toggles each of the set of matched elements.' name='toggle'>
<desc>Toggles each of the set of matched elements. If they are shown,
toggle makes them hidden. If they are hidden, toggle
makes them shown.</desc>
<examples>
<code>$("p").toggle()</code>
<result>[ &lt;p style="display: none"&gt;Hello&lt;/p&gt;, &lt;p style="display: block"&gt;Hello Again&lt;/p&gt; ]</result>
<before>&lt;p&gt;Hello&lt;/p&gt;&lt;p style="display: none"&gt;Hello Again&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM' type='jQuery' short='Adds the specified class to each of the set of matched elements.' name='addClass'>
<desc>Adds the specified class to each of the set of matched elements.</desc>
<params type='String' name='class'>
<desc>A CSS class to add to the elements</desc>
</params>
<examples>
<code>$("p").addClass("selected")</code>
<result>[ &lt;p class="selected"&gt;Hello&lt;/p&gt; ]</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM' type='jQuery' short='Removes the specified class from the set of matched elements.' name='removeClass'>
<desc>Removes the specified class from the set of matched elements.</desc>
<params type='String' name='class'>
<desc>A CSS class to remove from the elements</desc>
</params>
<examples>
<code>$("p").removeClass("selected")</code>
<result>[ &lt;p&gt;Hello&lt;/p&gt; ]</result>
<before>&lt;p class="selected"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM' type='jQuery' short='Adds the specified class if it is not present, removes it if it is
present.' name='toggleClass'>
<desc>Adds the specified class if it is not present, removes it if it is
present.</desc>
<params type='String' name='class'>
<desc>A CSS class with which to toggle the elements</desc>
</params>
<examples>
<code>$("p").toggleClass("selected")</code>
<result>[ &lt;p class="selected"&gt;Hello&lt;/p&gt;, &lt;p&gt;Hello Again&lt;/p&gt; ]</result>
<before>&lt;p&gt;Hello&lt;/p&gt;&lt;p class="selected"&gt;Hello Again&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Removes all matched elements from the DOM.' name='remove'>
<desc>Removes all matched elements from the DOM. This does NOT remove them from the
jQuery object, allowing you to use the matched elements further.</desc>
<examples>
<code>$("p").remove();</code>
<result>how are</result>
<before>&lt;p&gt;Hello&lt;/p&gt; how are &lt;p&gt;you?&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Removes only elements (out of the list of matched elements) that match
the specified jQuery expression.' name='remove'>
<desc>Removes only elements (out of the list of matched elements) that match
the specified jQuery expression. This does NOT remove them from the
jQuery object, allowing you to use the matched elements further.</desc>
<params type='String' name='expr'>
<desc>A jQuery expression to filter elements by.</desc>
</params>
<examples>
<code>$("p").remove(".hello");</code>
<result>how are &lt;p&gt;you?&lt;/p&gt;</result>
<before>&lt;p class="hello"&gt;Hello&lt;/p&gt; how are &lt;p&gt;you?&lt;/p&gt;</before>
</examples>
</method>
<method cat='DOM/Manipulation' type='jQuery' short='Removes all child nodes from the set of matched elements.' name='empty'>
<desc>Removes all child nodes from the set of matched elements.</desc>
<examples>
<code>$("p").empty()</code>
<result>[ &lt;p&gt;&lt;/p&gt; ]</result>
<before>&lt;p&gt;Hello, &lt;span&gt;Person&lt;/span&gt; &lt;a href="#"&gt;and person&lt;/a&gt;&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events' type='jQuery' short='Binds a handler to a particular event (like click) for each matched element.' name='bind'>
<desc>Binds a handler to a particular event (like click) for each matched element.
The event handler is passed an event object that you can use to prevent
default behaviour. To stop both default action and event bubbling, your handler
has to return false.</desc>
<params type='String' name='type'>
<desc>An event type</desc>
</params>
<params type='Function' name='fn'>
<desc>A function to bind to the event on each of the set of matched elements</desc>
</params>
<examples>
<code>$("p").bind( "click", function() {
  alert( $(this).text() );
} )</code>
<result>alert("Hello")</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
<examples>
<desc>Cancel a default action and prevent it from bubbling by returning false
from your function.</desc>
<code>$("form").bind( "submit", function() { return false; } )</code>
</examples>
<examples>
<desc>Cancel only the default action by using the preventDefault method.</desc>
<code>$("form").bind( "submit", function(event) {
  event.preventDefault();
} );</code>
</examples>
<examples>
<desc>Stop only an event from bubbling by using the stopPropagation method.</desc>
<code>$("form").bind( "submit", function(event) {
  event.stopPropagation();
} )</code>
</examples>
</method>
<method cat='Events' type='jQuery' short='The opposite of bind, removes a bound event from each of the matched
elements.' name='unbind'>
<desc>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.</desc>
<params type='String' name='type'>
<desc>An event type</desc>
</params>
<params type='Function' name='fn'>
<desc>A function to unbind from the event on each of the set of matched elements</desc>
</params>
<examples>
<code>$("p").unbind( "click", function() { alert("Hello"); } )</code>
<result>[ &lt;p&gt;Hello&lt;/p&gt; ]</result>
<before>&lt;p onclick="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events' type='jQuery' short='Removes all bound events of a particular type from each of the matched
elements.' name='unbind'>
<desc>Removes all bound events of a particular type from each of the matched
elements.</desc>
<params type='String' name='type'>
<desc>An event type</desc>
</params>
<examples>
<code>$("p").unbind( "click" )</code>
<result>[ &lt;p&gt;Hello&lt;/p&gt; ]</result>
<before>&lt;p onclick="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events' type='jQuery' short='Removes all bound events from each of the matched elements.' name='unbind'>
<desc>Removes all bound events from each of the matched elements.</desc>
<examples>
<code>$("p").unbind()</code>
<result>[ &lt;p&gt;Hello&lt;/p&gt; ]</result>
<before>&lt;p onclick="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events' type='jQuery' short='Trigger a type of event on every matched element.' name='trigger'>
<desc>Trigger a type of event on every matched element.</desc>
<params type='String' name='type'>
<desc>An event type to trigger.</desc>
</params>
<examples>
<code>$("p").trigger("click")</code>
<result>alert('hello')</result>
<before>&lt;p click="alert('hello')"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events' type='jQuery' short='Toggle between two function calls every other click.' name='toggle'>
<desc>Toggle between two function calls every other click.
Whenever a matched element is clicked, the first specified function 
is fired, when clicked again, the second is fired. All subsequent 
clicks continue to rotate through the two functions.</desc>
<params type='Function' name='even'>
<desc>The function to execute on every even click.</desc>
</params>
<params type='Function' name='odd'>
<desc>The function to execute on every odd click.</desc>
</params>
<examples>
<code>$("p").toggle(function(){
  $(this).addClass("selected");
},function(){
  $(this).removeClass("selected");
});</code>
</examples>
</method>
<method cat='Events' type='jQuery' short='A method for simulating hovering (moving the mouse on, and off,
an object).' name='hover'>
<desc>A method for simulating hovering (moving the mouse on, and off,
an object). This is a custom method which provides an 'in' to a 
frequent task.

Whenever the mouse cursor is moved over a matched 
element, the first specified function is fired. Whenever the mouse 
moves off of the element, the second specified function fires. 
Additionally, checks are in place to see if the mouse is still within 
the specified element itself (for example, an image inside of a div), 
and if it is, it will continue to 'hover', and not move out 
(a common error in using a mouseout event handler).</desc>
<params type='Function' name='over'>
<desc>The function to fire whenever the mouse is moved over a matched element.</desc>
</params>
<params type='Function' name='out'>
<desc>The function to fire whenever the mouse is moved off of a matched element.</desc>
</params>
<examples>
<code>$("p").hover(function(){
  $(this).addClass("over");
},function(){
  $(this).addClass("out");
});</code>
</examples>
</method>
<method cat='Events' type='jQuery' short='Bind a function to be executed whenever the DOM is ready to be
traversed and manipulated.' name='ready'>
<desc>Bind a function to be executed whenever the DOM is ready to be
traversed and manipulated. This is probably the most important 
function included in the event module, as it can greatly improve
the response times of your web applications.

In a nutshell, this is a solid replacement for using window.onload, 
and attaching a function to that. By using this method, your bound Function 
will be called the instant the DOM is ready to be read and manipulated, 
which is exactly what 99.99% of all Javascript code needs to run.

Please ensure you have no code in your &lt;body&gt; onload event handler, 
otherwise $(document).ready() may not fire.

You can have as many $(document).ready events on your page as you like.</desc>
<params type='Function' name='fn'>
<desc>The function to be executed when the DOM is ready.</desc>
</params>
<examples>
<code>$(document).ready(function(){ Your code here... });</code>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Bind a function to the scroll event of each matched element.' name='scroll'>
<desc>Bind a function to the scroll event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the scroll event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").scroll( function() { alert("Hello"); } );</code>
<result>&lt;p onscroll="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Trigger the scroll event of each matched element.' name='scroll'>
<desc>Trigger the scroll event of each matched element. This causes all of the functions
that have been bound to thet scroll event to be executed.</desc>
<examples>
<code>$("p").scroll();</code>
<result>alert('Hello');</result>
<before>&lt;p onscroll="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Bind a function to the scroll event of each matched element, which will only be executed once.' name='onescroll'>
<desc>Bind a function to the scroll event of each matched element, which will only be executed once.
Unlike a call to the normal .scroll() method, calling .onescroll() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the scroll event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").onescroll( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first scroll</result>
<before>&lt;p onscroll="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Removes a bound scroll event from each of the matched
elements.' name='unscroll'>
<desc>Removes a bound scroll event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the scroll event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unscroll( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onscroll="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Removes all bound scroll events from each of the matched elements.' name='unscroll'>
<desc>Removes all bound scroll events from each of the matched elements.</desc>
<examples>
<code>$("p").unscroll();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onscroll="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Form' type='jQuery' short='Bind a function to the submit event of each matched element.' name='submit'>
<desc>Bind a function to the submit event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the submit event on each of the matched elements.</desc>
</params>
<examples>
<desc>Prevents the form submission when the input has no value entered.</desc>
<code>$("#myform").submit( function() {
  return $("input", this).val().length &gt; 0;
} );</code>
<before>&lt;form id="myform"&gt;&lt;input /&gt;&lt;/form&gt;</before>
</examples>
</method>
<method cat='Events/Form' type='jQuery' short='Trigger the submit event of each matched element.' name='submit'>
<desc>Trigger the submit event of each matched element. This causes all of the functions
that have been bound to thet submit event to be executed.

Note: This does not execute the submit method of the form element! If you need to
submit the form via code, you have to use the DOM method, eg. $("form")[0].submit();</desc>
<examples>
<desc>Triggers all submit events registered for forms, but does not submit the form</desc>
<code>$("form").submit();</code>
</examples>
</method>
<method cat='Events/Form' type='jQuery' short='Bind a function to the submit event of each matched element, which will only be executed once.' name='onesubmit'>
<desc>Bind a function to the submit event of each matched element, which will only be executed once.
Unlike a call to the normal .submit() method, calling .onesubmit() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the submit event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").onesubmit( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first submit</result>
<before>&lt;p onsubmit="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Form' type='jQuery' short='Removes a bound submit event from each of the matched
elements.' name='unsubmit'>
<desc>Removes a bound submit event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the submit event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unsubmit( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onsubmit="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Form' type='jQuery' short='Removes all bound submit events from each of the matched elements.' name='unsubmit'>
<desc>Removes all bound submit events from each of the matched elements.</desc>
<examples>
<code>$("p").unsubmit();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onsubmit="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/UI' type='jQuery' short='Bind a function to the focus event of each matched element.' name='focus'>
<desc>Bind a function to the focus event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the focus event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").focus( function() { alert("Hello"); } );</code>
<result>&lt;p onfocus="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/UI' type='jQuery' short='Trigger the focus event of each matched element.' name='focus'>
<desc>Trigger the focus event of each matched element. This causes all of the functions
that have been bound to thet focus event to be executed.</desc>
<examples>
<code>$("p").focus();</code>
<result>alert('Hello');</result>
<before>&lt;p onfocus="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/UI' type='jQuery' short='Bind a function to the focus event of each matched element, which will only be executed once.' name='onefocus'>
<desc>Bind a function to the focus event of each matched element, which will only be executed once.
Unlike a call to the normal .focus() method, calling .onefocus() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the focus event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").onefocus( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first focus</result>
<before>&lt;p onfocus="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/UI' type='jQuery' short='Removes a bound focus event from each of the matched
elements.' name='unfocus'>
<desc>Removes a bound focus event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the focus event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unfocus( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onfocus="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/UI' type='jQuery' short='Removes all bound focus events from each of the matched elements.' name='unfocus'>
<desc>Removes all bound focus events from each of the matched elements.</desc>
<examples>
<code>$("p").unfocus();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onfocus="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Keyboard' type='jQuery' short='Bind a function to the keydown event of each matched element.' name='keydown'>
<desc>Bind a function to the keydown event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the keydown event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").keydown( function() { alert("Hello"); } );</code>
<result>&lt;p onkeydown="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Keyboard' type='jQuery' short='Trigger the keydown event of each matched element.' name='keydown'>
<desc>Trigger the keydown event of each matched element. This causes all of the functions
that have been bound to thet keydown event to be executed.</desc>
<examples>
<code>$("p").keydown();</code>
<result>alert('Hello');</result>
<before>&lt;p onkeydown="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Keyboard' type='jQuery' short='Bind a function to the keydown event of each matched element, which will only be executed once.' name='onekeydown'>
<desc>Bind a function to the keydown event of each matched element, which will only be executed once.
Unlike a call to the normal .keydown() method, calling .onekeydown() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the keydown event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").onekeydown( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first keydown</result>
<before>&lt;p onkeydown="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Keyboard' type='jQuery' short='Removes a bound keydown event from each of the matched
elements.' name='unkeydown'>
<desc>Removes a bound keydown event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the keydown event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unkeydown( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onkeydown="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Keyboard' type='jQuery' short='Removes all bound keydown events from each of the matched elements.' name='unkeydown'>
<desc>Removes all bound keydown events from each of the matched elements.</desc>
<examples>
<code>$("p").unkeydown();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onkeydown="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Bind a function to the dblclick event of each matched element.' name='dblclick'>
<desc>Bind a function to the dblclick event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the dblclick event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").dblclick( function() { alert("Hello"); } );</code>
<result>&lt;p ondblclick="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Trigger the dblclick event of each matched element.' name='dblclick'>
<desc>Trigger the dblclick event of each matched element. This causes all of the functions
that have been bound to thet dblclick event to be executed.</desc>
<examples>
<code>$("p").dblclick();</code>
<result>alert('Hello');</result>
<before>&lt;p ondblclick="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Bind a function to the dblclick event of each matched element, which will only be executed once.' name='onedblclick'>
<desc>Bind a function to the dblclick event of each matched element, which will only be executed once.
Unlike a call to the normal .dblclick() method, calling .onedblclick() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the dblclick event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").onedblclick( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first dblclick</result>
<before>&lt;p ondblclick="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Removes a bound dblclick event from each of the matched
elements.' name='undblclick'>
<desc>Removes a bound dblclick event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the dblclick event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").undblclick( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p ondblclick="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Removes all bound dblclick events from each of the matched elements.' name='undblclick'>
<desc>Removes all bound dblclick events from each of the matched elements.</desc>
<examples>
<code>$("p").undblclick();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p ondblclick="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Keyboard' type='jQuery' short='Bind a function to the keypress event of each matched element.' name='keypress'>
<desc>Bind a function to the keypress event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the keypress event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").keypress( function() { alert("Hello"); } );</code>
<result>&lt;p onkeypress="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Keyboard' type='jQuery' short='Trigger the keypress event of each matched element.' name='keypress'>
<desc>Trigger the keypress event of each matched element. This causes all of the functions
that have been bound to thet keypress event to be executed.</desc>
<examples>
<code>$("p").keypress();</code>
<result>alert('Hello');</result>
<before>&lt;p onkeypress="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Keyboard' type='jQuery' short='Bind a function to the keypress event of each matched element, which will only be executed once.' name='onekeypress'>
<desc>Bind a function to the keypress event of each matched element, which will only be executed once.
Unlike a call to the normal .keypress() method, calling .onekeypress() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the keypress event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").onekeypress( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first keypress</result>
<before>&lt;p onkeypress="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Keyboard' type='jQuery' short='Removes a bound keypress event from each of the matched
elements.' name='unkeypress'>
<desc>Removes a bound keypress event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the keypress event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unkeypress( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onkeypress="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Keyboard' type='jQuery' short='Removes all bound keypress events from each of the matched elements.' name='unkeypress'>
<desc>Removes all bound keypress events from each of the matched elements.</desc>
<examples>
<code>$("p").unkeypress();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onkeypress="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Bind a function to the error event of each matched element.' name='error'>
<desc>Bind a function to the error event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the error event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").error( function() { alert("Hello"); } );</code>
<result>&lt;p onerror="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Trigger the error event of each matched element.' name='error'>
<desc>Trigger the error event of each matched element. This causes all of the functions
that have been bound to thet error event to be executed.</desc>
<examples>
<code>$("p").error();</code>
<result>alert('Hello');</result>
<before>&lt;p onerror="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Bind a function to the error event of each matched element, which will only be executed once.' name='oneerror'>
<desc>Bind a function to the error event of each matched element, which will only be executed once.
Unlike a call to the normal .error() method, calling .oneerror() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the error event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").oneerror( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first error</result>
<before>&lt;p onerror="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Removes a bound error event from each of the matched
elements.' name='unerror'>
<desc>Removes a bound error event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the error event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unerror( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onerror="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Removes all bound error events from each of the matched elements.' name='unerror'>
<desc>Removes all bound error events from each of the matched elements.</desc>
<examples>
<code>$("p").unerror();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onerror="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/UI' type='jQuery' short='Bind a function to the blur event of each matched element.' name='blur'>
<desc>Bind a function to the blur event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the blur event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").blur( function() { alert("Hello"); } );</code>
<result>&lt;p onblur="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/UI' type='jQuery' short='Trigger the blur event of each matched element.' name='blur'>
<desc>Trigger the blur event of each matched element. This causes all of the functions
that have been bound to thet blur event to be executed.</desc>
<examples>
<code>$("p").blur();</code>
<result>alert('Hello');</result>
<before>&lt;p onblur="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/UI' type='jQuery' short='Bind a function to the blur event of each matched element, which will only be executed once.' name='oneblur'>
<desc>Bind a function to the blur event of each matched element, which will only be executed once.
Unlike a call to the normal .blur() method, calling .oneblur() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the blur event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").oneblur( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first blur</result>
<before>&lt;p onblur="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/UI' type='jQuery' short='Removes a bound blur event from each of the matched
elements.' name='unblur'>
<desc>Removes a bound blur event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the blur event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unblur( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onblur="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/UI' type='jQuery' short='Removes all bound blur events from each of the matched elements.' name='unblur'>
<desc>Removes all bound blur events from each of the matched elements.</desc>
<examples>
<code>$("p").unblur();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onblur="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Bind a function to the load event of each matched element.' name='load'>
<desc>Bind a function to the load event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the load event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").load( function() { alert("Hello"); } );</code>
<result>&lt;p onload="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Trigger the load event of each matched element.' private='1' name='load'>
<desc>Trigger the load event of each matched element. This causes all of the functions
that have been bound to thet load event to be executed.

Marked as private: Calling load() without arguments throws exception because the ajax load
does not handle it.</desc>
<examples>
<code>$("p").load();</code>
<result>alert('Hello');</result>
<before>&lt;p onload="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Bind a function to the load event of each matched element, which will only be executed once.' name='oneload'>
<desc>Bind a function to the load event of each matched element, which will only be executed once.
Unlike a call to the normal .load() method, calling .oneload() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the load event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").oneload( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first load</result>
<before>&lt;p onload="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Removes a bound load event from each of the matched
elements.' name='unload'>
<desc>Removes a bound load event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the load event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unload( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onload="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Removes all bound load events from each of the matched elements.' name='unload'>
<desc>Removes all bound load events from each of the matched elements.</desc>
<examples>
<code>$("p").unload();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onload="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Form' type='jQuery' short='Bind a function to the select event of each matched element.' name='select'>
<desc>Bind a function to the select event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the select event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").select( function() { alert("Hello"); } );</code>
<result>&lt;p onselect="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Form' type='jQuery' short='Trigger the select event of each matched element.' name='select'>
<desc>Trigger the select event of each matched element. This causes all of the functions
that have been bound to thet select event to be executed.</desc>
<examples>
<code>$("p").select();</code>
<result>alert('Hello');</result>
<before>&lt;p onselect="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Form' type='jQuery' short='Bind a function to the select event of each matched element, which will only be executed once.' name='oneselect'>
<desc>Bind a function to the select event of each matched element, which will only be executed once.
Unlike a call to the normal .select() method, calling .oneselect() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the select event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").oneselect( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first select</result>
<before>&lt;p onselect="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Form' type='jQuery' short='Removes a bound select event from each of the matched
elements.' name='unselect'>
<desc>Removes a bound select event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the select event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unselect( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onselect="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Form' type='jQuery' short='Removes all bound select events from each of the matched elements.' name='unselect'>
<desc>Removes all bound select events from each of the matched elements.</desc>
<examples>
<code>$("p").unselect();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onselect="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Bind a function to the mouseup event of each matched element.' name='mouseup'>
<desc>Bind a function to the mouseup event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the mouseup event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").mouseup( function() { alert("Hello"); } );</code>
<result>&lt;p onmouseup="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Trigger the mouseup event of each matched element.' name='mouseup'>
<desc>Trigger the mouseup event of each matched element. This causes all of the functions
that have been bound to thet mouseup event to be executed.</desc>
<examples>
<code>$("p").mouseup();</code>
<result>alert('Hello');</result>
<before>&lt;p onmouseup="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Bind a function to the mouseup event of each matched element, which will only be executed once.' name='onemouseup'>
<desc>Bind a function to the mouseup event of each matched element, which will only be executed once.
Unlike a call to the normal .mouseup() method, calling .onemouseup() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the mouseup event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").onemouseup( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first mouseup</result>
<before>&lt;p onmouseup="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Removes a bound mouseup event from each of the matched
elements.' name='unmouseup'>
<desc>Removes a bound mouseup event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the mouseup event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unmouseup( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onmouseup="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Removes all bound mouseup events from each of the matched elements.' name='unmouseup'>
<desc>Removes all bound mouseup events from each of the matched elements.</desc>
<examples>
<code>$("p").unmouseup();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onmouseup="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Bind a function to the unload event of each matched element.' name='unload'>
<desc>Bind a function to the unload event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the unload event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unload( function() { alert("Hello"); } );</code>
<result>&lt;p onunload="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Trigger the unload event of each matched element.' name='unload'>
<desc>Trigger the unload event of each matched element. This causes all of the functions
that have been bound to thet unload event to be executed.</desc>
<examples>
<code>$("p").unload();</code>
<result>alert('Hello');</result>
<before>&lt;p onunload="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Bind a function to the unload event of each matched element, which will only be executed once.' name='oneunload'>
<desc>Bind a function to the unload event of each matched element, which will only be executed once.
Unlike a call to the normal .unload() method, calling .oneunload() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the unload event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").oneunload( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first unload</result>
<before>&lt;p onunload="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Removes a bound unload event from each of the matched
elements.' name='ununload'>
<desc>Removes a bound unload event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the unload event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").ununload( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onunload="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Removes all bound unload events from each of the matched elements.' name='ununload'>
<desc>Removes all bound unload events from each of the matched elements.</desc>
<examples>
<code>$("p").ununload();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onunload="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Form' type='jQuery' short='Bind a function to the change event of each matched element.' name='change'>
<desc>Bind a function to the change event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the change event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").change( function() { alert("Hello"); } );</code>
<result>&lt;p onchange="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Form' type='jQuery' short='Trigger the change event of each matched element.' name='change'>
<desc>Trigger the change event of each matched element. This causes all of the functions
that have been bound to thet change event to be executed.</desc>
<examples>
<code>$("p").change();</code>
<result>alert('Hello');</result>
<before>&lt;p onchange="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Form' type='jQuery' short='Bind a function to the change event of each matched element, which will only be executed once.' name='onechange'>
<desc>Bind a function to the change event of each matched element, which will only be executed once.
Unlike a call to the normal .change() method, calling .onechange() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the change event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").onechange( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first change</result>
<before>&lt;p onchange="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Form' type='jQuery' short='Removes a bound change event from each of the matched
elements.' name='unchange'>
<desc>Removes a bound change event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the change event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unchange( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onchange="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Form' type='jQuery' short='Removes all bound change events from each of the matched elements.' name='unchange'>
<desc>Removes all bound change events from each of the matched elements.</desc>
<examples>
<code>$("p").unchange();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onchange="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Bind a function to the mouseout event of each matched element.' name='mouseout'>
<desc>Bind a function to the mouseout event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the mouseout event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").mouseout( function() { alert("Hello"); } );</code>
<result>&lt;p onmouseout="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Trigger the mouseout event of each matched element.' name='mouseout'>
<desc>Trigger the mouseout event of each matched element. This causes all of the functions
that have been bound to thet mouseout event to be executed.</desc>
<examples>
<code>$("p").mouseout();</code>
<result>alert('Hello');</result>
<before>&lt;p onmouseout="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Bind a function to the mouseout event of each matched element, which will only be executed once.' name='onemouseout'>
<desc>Bind a function to the mouseout event of each matched element, which will only be executed once.
Unlike a call to the normal .mouseout() method, calling .onemouseout() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the mouseout event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").onemouseout( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first mouseout</result>
<before>&lt;p onmouseout="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Removes a bound mouseout event from each of the matched
elements.' name='unmouseout'>
<desc>Removes a bound mouseout event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the mouseout event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unmouseout( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onmouseout="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Removes all bound mouseout events from each of the matched elements.' name='unmouseout'>
<desc>Removes all bound mouseout events from each of the matched elements.</desc>
<examples>
<code>$("p").unmouseout();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onmouseout="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Keyboard' type='jQuery' short='Bind a function to the keyup event of each matched element.' name='keyup'>
<desc>Bind a function to the keyup event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the keyup event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").keyup( function() { alert("Hello"); } );</code>
<result>&lt;p onkeyup="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Keyboard' type='jQuery' short='Trigger the keyup event of each matched element.' name='keyup'>
<desc>Trigger the keyup event of each matched element. This causes all of the functions
that have been bound to thet keyup event to be executed.</desc>
<examples>
<code>$("p").keyup();</code>
<result>alert('Hello');</result>
<before>&lt;p onkeyup="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Keyboard' type='jQuery' short='Bind a function to the keyup event of each matched element, which will only be executed once.' name='onekeyup'>
<desc>Bind a function to the keyup event of each matched element, which will only be executed once.
Unlike a call to the normal .keyup() method, calling .onekeyup() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the keyup event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").onekeyup( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first keyup</result>
<before>&lt;p onkeyup="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Keyboard' type='jQuery' short='Removes a bound keyup event from each of the matched
elements.' name='unkeyup'>
<desc>Removes a bound keyup event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the keyup event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unkeyup( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onkeyup="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Keyboard' type='jQuery' short='Removes all bound keyup events from each of the matched elements.' name='unkeyup'>
<desc>Removes all bound keyup events from each of the matched elements.</desc>
<examples>
<code>$("p").unkeyup();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onkeyup="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Bind a function to the click event of each matched element.' name='click'>
<desc>Bind a function to the click event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the click event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").click( function() { alert("Hello"); } );</code>
<result>&lt;p onclick="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Trigger the click event of each matched element.' name='click'>
<desc>Trigger the click event of each matched element. This causes all of the functions
that have been bound to thet click event to be executed.</desc>
<examples>
<code>$("p").click();</code>
<result>alert('Hello');</result>
<before>&lt;p onclick="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Bind a function to the click event of each matched element, which will only be executed once.' name='oneclick'>
<desc>Bind a function to the click event of each matched element, which will only be executed once.
Unlike a call to the normal .click() method, calling .oneclick() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the click event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").oneclick( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first click</result>
<before>&lt;p onclick="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Removes a bound click event from each of the matched
elements.' name='unclick'>
<desc>Removes a bound click event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the click event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unclick( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onclick="myFunction"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Mouse' type='jQuery' short='Removes all bound click events from each of the matched elements.' name='unclick'>
<desc>Removes all bound click events from each of the matched elements.</desc>
<examples>
<code>$("p").unclick();</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onclick="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Bind a function to the resize event of each matched element.' name='resize'>
<desc>Bind a function to the resize event of each matched element.</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the resize event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").resize( function() { alert("Hello"); } );</code>
<result>&lt;p onresize="alert('Hello');"&gt;Hello&lt;/p&gt;</result>
<before>&lt;p&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Trigger the resize event of each matched element.' name='resize'>
<desc>Trigger the resize event of each matched element. This causes all of the functions
that have been bound to thet resize event to be executed.</desc>
<examples>
<code>$("p").resize();</code>
<result>alert('Hello');</result>
<before>&lt;p onresize="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Bind a function to the resize event of each matched element, which will only be executed once.' name='oneresize'>
<desc>Bind a function to the resize event of each matched element, which will only be executed once.
Unlike a call to the normal .resize() method, calling .oneresize() causes the bound function to be
only executed the first time it is triggered, and never again (unless it is re-bound).</desc>
<params type='Function' name='fn'>
<desc>A function to bind to the resize event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").oneresize( function() { alert("Hello"); } );</code>
<result>alert('Hello'); // Only executed for the first resize</result>
<before>&lt;p onresize="alert('Hello');"&gt;Hello&lt;/p&gt;</before>
</examples>
</method>
<method cat='Events/Browser' type='jQuery' short='Removes a bound resize event from each of the matched
elements.' name='unresize'>
<desc>Removes a bound resize event from each of the matched
elements. You must pass the identical function that was used in the original 
bind method.</desc>
<params type='Function' name='fn'>
<desc>A function to unbind from the resize event on each of the matched elements.</desc>
</params>
<examples>
<code>$("p").unresize( myFunction );</code>
<result>&lt;p&gt;Hello&lt;/p&gt;</result>
<before>&lt;p onresize="myFuncti