Hello
- * @resultHello
+ * @example $("#myform").submit( function() { + * return $("input", this).val().length > 0; + * } ); + * @before + * @desc Prevents the form submission when the input has no value entered. * * @name submit * @type jQuery @@ -237,9 +247,11 @@ new function(){ * 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. * - * @example $("p").submit(); - * @beforeHello
- * @result alert('Hello'); + * 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(); + * + * @example $("form").submit(); + * @desc Triggers all submit events registered for forms, but does not submit the form * * @name submit * @type jQuery @@ -305,6 +317,9 @@ new function(){ * 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. * + * Note: This does not execute the focus method of the underlying elements! If you need to + * focus an element via code, you have to use the DOM method, eg. $("#myinput")[0].focus(); + * * @example $("p").focus(); * @beforeHello
* @result alert('Hello'); @@ -645,6 +660,9 @@ new function(){ * 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. * + * Note: This does not execute the blur method of the underlying elements! If you need to + * blur an element via code, you have to use the DOM method, eg. $("#myinput")[0].blur(); + * * @example $("p").blur(); * @beforeHello
* @result alert('Hello'); @@ -713,11 +731,15 @@ new function(){ * 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. + * * @example $("p").load(); * @beforeHello
* @result alert('Hello'); * * @name load + * @private * @type jQuery * @cat Events/Browser */ @@ -1444,50 +1466,76 @@ new function(){ * @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 - */ + /** + * Bind a function to the mouseover event of each matched element. + * + * @example $("p").mouseover( function() { alert("Hello"); } ); + * @beforeHello
+ * @resultHello
+ * + * @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(); + * @beforeHello
+ * @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"); } ); + * @beforeHello
+ * @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 ); + * @beforeHello
+ * @resultHello
+ * + * @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(); + * @beforeHello
+ * @resultHello
+ * + * @name unmouseover + * @type jQuery + * @cat Events/Mouse + */ var e = ("blur,focus,load,resize,scroll,unload,click,dblclick," + - "mousedown,mouseup,mousemove,mouseover,mouseout,change,reset,select," + + "mousedown,mouseup,mousemove,mouseover,mouseout,change,select," + "submit,keydown,keypress,keyup,error").split(","); // Go through all the event names, but make sure that @@ -1506,20 +1554,16 @@ new function(){ // Finally, handle events that only fire once jQuery.fn["one"+o] = function(f){ - // Attach the event listener - return this.each(function(){ - - var count = 0; - - // Add the event - jQuery.event.add( this, o, function(e){ - // If this function has already been executed, stop - if ( count++ ) return; - - // And execute the bound function - return f.apply(this, [e]); - }); - }); + // save cloned reference to this + var element = jQuery(this); + var handler = function() { + // unbind itself when executed + element.unbind(o, handler); + element = null; + // apply original handler with the same arguments + return f.apply(this, arguments); + }; + return this.bind(o, handler); }; }; @@ -1539,11 +1583,12 @@ new function(){ // Use the defer script hack var script = document.getElementById("__ie_init"); - script.onreadystatechange = function() { - if ( this.readyState != "complete" ) return; - this.parentNode.removeChild( this ); - jQuery.ready(); - }; + if (script) // script does not exist if jQuery is loaded dynamically + script.onreadystatechange = function() { + if ( this.readyState != "complete" ) return; + this.parentNode.removeChild( this ); + jQuery.ready(); + }; // Clear from memory script = null; @@ -1570,3 +1615,12 @@ new function(){ jQuery.event.add( window, "load", jQuery.ready ); }; + +// Clean up after IE to avoid memory leaks +if (jQuery.browser.msie) jQuery(window).unload(function() { + var event = jQuery.event, global = event.global; + for (var type in global) { + var els = global[type], i = els.length; + if (i>0) do if (type != 'unload') event.remove(els[i-1], type); while (--i); + } +});