Fixed docs for html()
[jquery.git] / src / jquery / jquery.js
index 025dd77..8a0a115 100644 (file)
@@ -1960,9 +1960,6 @@ jQuery.extend({
 \r
                        event = jQuery.event.fix( event || window.event || {} ); // Empty object is for triggered events with no data\r
 \r
-                       // If no correct event was found, fail\r
-                       if ( !event ) return false;\r
-\r
                        var returnValue = true;\r
 \r
                        var c = this.events[event.type];\r
@@ -1985,20 +1982,19 @@ jQuery.extend({
                },\r
 \r
                fix: function(event) {\r
-                       // check IE\r
-                       if(jQuery.browser.msie) {\r
-                               // fix target property, if available\r
-                               // check prevents overwriting of fake target coming from trigger\r
-                               if(event.srcElement)\r
-                                       event.target = event.srcElement;\r
-                                       \r
-                               // calculate pageX/Y\r
+                       // fix target property, if available\r
+                       if(event.srcElement)\r
+                               event.target = event.srcElement;\r
+               \r
+                       // calculate pageX/Y if missing\r
+                       if(typeof event.pageX == "undefined") {\r
                                var e = document.documentElement, b = document.body;\r
                                event.pageX = event.clientX + (e.scrollLeft || b.scrollLeft);\r
                                event.pageY = event.clientY + (e.scrollTop || b.scrollTop);\r
+                       }\r
                                        \r
-                       // check safari and if target is a textnode\r
-                       } else if(jQuery.browser.safari && event.target.nodeType == 3) {\r
+                       // check if target is a textnode (only for safari)\r
+                       if(jQuery.browser.safari && event.target.nodeType == 3) {\r
                                // target is readonly, clone the event object\r
                                event = jQuery.extend({}, event);\r
                                // get parentnode from textnode\r
@@ -2006,15 +2002,17 @@ jQuery.extend({
                        }\r
                        \r
                        // fix preventDefault and stopPropagation\r
-                       if (!event.preventDefault)\r
+                       if (!event.preventDefault) {\r
                                event.preventDefault = function() {\r
                                        this.returnValue = false;\r
                                };\r
+                       }\r
                                \r
-                       if (!event.stopPropagation)\r
+                       if (!event.stopPropagation) {\r
                                event.stopPropagation = function() {\r
                                        this.cancelBubble = true;\r
                                };\r
+                       }\r
                                \r
                        return event;\r
                }\r
@@ -2463,6 +2461,9 @@ jQuery.macros = {
                /**\r
                 * Get the html contents of the first matched element.\r
                 *\r
+                * A wrapper for the innerHTML property of DOM elements, therefore\r
+                * not available for XML documents.\r
+                *\r
                 * @example $("div").html();\r
                 * @before <div><input/></div>\r
                 * @result <input/>\r
@@ -2475,6 +2476,9 @@ jQuery.macros = {
                /**\r
                 * Set the html contents of every matched element.\r
                 *\r
+                * A wrapper for the innerHTML property of DOM elements, therefore\r
+                * not available for XML documents.\r
+                *\r
                 * @example $("div").html("<b>new stuff</b>");\r
                 * @before <div><input/></div>\r
                 * @result <div><b>new stuff</b></div>\r