X-Git-Url: http://git.asbjorn.biz/?a=blobdiff_plain;f=src%2Fevent%2Fevent.js;h=ff1d936fd70bddbc5b19abbf2b9237cf506a9cb6;hb=394334671cd4a0b22c01f724b30933fc83df863d;hp=bbf52a9e3b1be1d7c9dbc1c30d99bb08789a908d;hpb=c8009abcce562198cbc3930ed11f74dd62eba531;p=jquery.git

diff --git a/src/event/event.js b/src/event/event.js
index bbf52a9..ff1d936 100644
--- a/src/event/event.js
+++ b/src/event/event.js
@@ -15,6 +15,13 @@ jQuery.fn.extend({
 	 * },function(){
 	 *   $(this).removeClass("selected");
 	 * });
+	 * 
+	 * @test var count = 0;
+	 * var fn1 = function() { count++; }
+	 * var fn2 = function() { count--; }
+	 * var link = $('#mark');
+	 * link.click().toggle(fn1, fn2).click().click().click().click().click();
+	 * ok( count == 1, "Check for toggle(fn, fn)" );
 	 *
 	 * @name toggle
 	 * @type jQuery
@@ -64,7 +71,7 @@ jQuery.fn.extend({
 	 * @param Function over The function to fire whenever the mouse is moved over a matched element.
 	 * @param Function out The function to fire whenever the mouse is moved off of a matched element.
 	 * @cat Events
-	 */
+	 */
 	hover: function(f,g) {
 		
 		// A private function for haandling mouse 'hovering'
@@ -1443,6 +1450,117 @@ new function(){
 		 * @type jQuery
 		 * @cat Events/Mouse
 		 */
+		 
+		/**
+		 * Bind a function to the mouseover event of each matched element.
+		 *
+		 * @example $("p").mouseover( function() { alert("Hello"); } );
+		 * @before <p>Hello</p>
+		 * @result <p onmouseover="alert('Hello');">Hello</p>
+		 *
+		 * @name mouseover
+		 * @type jQuery
+		 * @param Function fn A function to bind to the mousedown event on each of the matched elements.
+		 * @cat Events/Mouse
+		 */
+
+		/**
+		 * Trigger the mouseover event of each matched element. This causes all of the functions
+		 * that have been bound to thet mousedown event to be executed.
+		 *
+		 * @example $("p").mouseover();
+		 * @before <p onmouseover="alert('Hello');">Hello</p>
+		 * @result alert('Hello');
+		 *
+		 * @name mouseover
+		 * @type jQuery
+		 * @cat Events/Mouse
+		 */
+
+		/**
+		 * Bind a function to the mouseover event of each matched element, which will only be executed once.
+		 * Unlike a call to the normal .mouseover() method, calling .onemouseover() causes the bound function to be
+		 * only executed the first time it is triggered, and never again (unless it is re-bound).
+		 *
+		 * @example $("p").onemouseover( function() { alert("Hello"); } );
+		 * @before <p onmouseover="alert('Hello');">Hello</p>
+		 * @result alert('Hello'); // Only executed for the first mouseover
+		 *
+		 * @name onemouseover
+		 * @type jQuery
+		 * @param Function fn A function to bind to the mouseover event on each of the matched elements.
+		 * @cat Events/Mouse
+		 */
+
+		/**
+		 * Removes a bound mouseover event from each of the matched
+		 * elements. You must pass the identical function that was used in the original 
+		 * bind method.
+		 *
+		 * @example $("p").unmouseover( myFunction );
+		 * @before <p onmouseover="myFunction">Hello</p>
+		 * @result <p>Hello</p>
+		 *
+		 * @name unmouseover
+		 * @type jQuery
+		 * @param Function fn A function to unbind from the mouseover event on each of the matched elements.
+		 * @cat Events/Mouse
+		 */
+
+		/**
+		 * Removes all bound mouseover events from each of the matched elements.
+		 *
+		 * @example $("p").unmouseover();
+		 * @before <p onmouseover="alert('Hello');">Hello</p>
+		 * @result <p>Hello</p>
+		 *
+		 * @name unmouseover
+		 * @type jQuery
+		 * @cat Events/Mouse
+		 */
+		 
+		 /**
+		  * @test var count;
+		  * var e = ("blur,focus,load,resize,scroll,unload,click,dblclick," +
+		  * 		"mousedown,mouseup,mousemove,mouseover,mouseout,change,reset,select," + 
+		  * 		"submit,keydown,keypress,keyup,error").split(",");
+		  * var handler1 = function(event) {
+		  * 	count++;
+		  * };
+		  * var handler2 = function(event) {
+		  * 	count++;
+		  * };
+		  * for( var i=0; i < e.length; i++) {
+		  * 	var event = e[i];
+		  * 	count = 0;
+		  * 	// bind handler
+		  * 	$(document)[event](handler1);
+		  *		$(document)[event](handler2);
+		  * 	$(document)["one"+event](handler1);
+		  * 	
+		  * 	// call event two times
+		  * 	$(document)[event]();
+		  * 	$(document)[event]();
+		  * 	
+		  * 	// unbind events
+		  * 	$(document)["un"+event](handler1);
+		  * 	// call once more
+		  * 	$(document)[event]();
+		  *
+		  * 	// remove all handlers
+		  *		$(document)["un"+event]();
+		  *
+		  * 	// call once more
+		  * 	$(document)[event]();
+		  * 	
+		  * 	// assert count
+		  * @test ok( count == 6, 'Checking event ' + event);
+		  * }
+		  *
+		  * @private
+		  * @name eventTesting
+		  * @cat Events
+		  */
 
 	var e = ("blur,focus,load,resize,scroll,unload,click,dblclick," +
 		"mousedown,mouseup,mousemove,mouseover,mouseout,change,reset,select," +