<?xml version='1.0' encoding='ISO-8859-1'?>
<?xml-stylesheet type='text/xsl' href='docs.xsl'?>
<docs>
<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("hover");
},function(){
  $(this).removeClass("hover");
});</code>
</examples>
</method></docs>
