X-Git-Url: http://git.asbjorn.biz/?a=blobdiff_plain;f=src%2Fajax%2Fajax.js;h=98f792a35ea36aea07639415f2cd9ebe1f77c403;hb=8ac2169dc01f646b9182a03353427f2c48cba49c;hp=45159a5f5d2661101097ee7beb7c0bc80c89d6ed;hpb=2daf49296abd4fcdf526a2c2814cd24e8f3eaff0;p=jquery.git diff --git a/src/ajax/ajax.js b/src/ajax/ajax.js index 45159a5..98f792a 100644 --- a/src/ajax/ajax.js +++ b/src/ajax/ajax.js @@ -13,7 +13,7 @@ jQuery.fn.extend({ * @param String url The URL of the HTML file to load. * @param Map params (optional) Key/value pairs that will be sent to the server. * @param Function callback (optional) A function to be executed whenever the data is loaded (parameters: responseText, status and response itself). - * @cat AJAX + * @cat Ajax */ loadIfModified: function( url, params, callback ) { this.load( url, params, callback, 1 ); @@ -41,10 +41,10 @@ jQuery.fn.extend({ * @param String url The URL of the HTML file to load. * @param Object params (optional) A set of key/value pairs that will be sent as data to the server. * @param Function callback (optional) A function to be executed whenever the data is loaded (parameters: responseText, status and response itself). - * @cat AJAX + * @cat Ajax */ load: function( url, params, callback, ifModified ) { - if ( url.constructor == Function ) + if ( jQuery.isFunction( url ) ) return this.bind("load", url); callback = callback || function(){}; @@ -53,9 +53,9 @@ jQuery.fn.extend({ var type = "GET"; // If the second parameter was provided - if ( params ) { + if ( params ) // If it's a function - if ( params.constructor == Function ) { + if ( jQuery.isFunction( params.constructor ) ) { // We assume that it's the callback callback = params; params = null; @@ -65,7 +65,6 @@ jQuery.fn.extend({ params = jQuery.param( params ); type = "POST"; } - } var self = this; @@ -76,14 +75,14 @@ jQuery.fn.extend({ data: params, ifModified: ifModified, complete: function(res, status){ - if ( status == "success" || !ifModified && status == "notmodified" ) { + if ( status == "success" || !ifModified && status == "notmodified" ) // Inject the HTML into all the matched elements - self.html(res.responseText) + self.attr("innerHTML", res.responseText) // Execute all the scripts inside of the newly-injected HTML .evalScripts() // Execute callback .each( callback, [res.responseText, status, res] ); - } else + else callback.apply( self, [res.responseText, status, res] ); } }); @@ -106,7 +105,7 @@ jQuery.fn.extend({ * * @name serialize * @type String - * @cat AJAX + * @cat Ajax */ serialize: function() { return jQuery.param( this ); @@ -119,15 +118,14 @@ jQuery.fn.extend({ * @name evalScripts * @type jQuery * @private - * @cat AJAX + * @cat Ajax */ evalScripts: function() { - return this.find('script').each(function(){ + return this.find("script").each(function(){ if ( this.src ) jQuery.getScript( this.src ); - else { + else jQuery.globalEval( this.text || this.textContent || this.innerHTML || "" ); - } }).end(); } @@ -154,7 +152,7 @@ if ( jQuery.browser.msie && typeof XMLHttpRequest == "undefined" ) * @name ajaxStart * @type jQuery * @param Function callback The function to execute. - * @cat AJAX + * @cat Ajax */ /** @@ -168,7 +166,7 @@ if ( jQuery.browser.msie && typeof XMLHttpRequest == "undefined" ) * @name ajaxStop * @type jQuery * @param Function callback The function to execute. - * @cat AJAX + * @cat Ajax */ /** @@ -185,7 +183,7 @@ if ( jQuery.browser.msie && typeof XMLHttpRequest == "undefined" ) * @name ajaxComplete * @type jQuery * @param Function callback The function to execute. - * @cat AJAX + * @cat Ajax */ /** @@ -203,7 +201,7 @@ if ( jQuery.browser.msie && typeof XMLHttpRequest == "undefined" ) * @name ajaxSuccess * @type jQuery * @param Function callback The function to execute. - * @cat AJAX + * @cat Ajax */ /** @@ -221,11 +219,11 @@ if ( jQuery.browser.msie && typeof XMLHttpRequest == "undefined" ) * @name ajaxError * @type jQuery * @param Function callback The function to execute. - * @cat AJAX + * @cat Ajax */ /** - * Attach a function to be executed before an AJAX request is send. + * Attach a function to be executed before an AJAX request is sent. * * The XMLHttpRequest and settings used for that request are passed * as arguments to the callback. @@ -233,24 +231,18 @@ if ( jQuery.browser.msie && typeof XMLHttpRequest == "undefined" ) * @example $("#msg").ajaxSend(function(request, settings){ * $(this).append("
  • Starting request at " + settings.url + "
  • "); * }); - * @desc Show a message before an AJAX request is send. + * @desc Show a message before an AJAX request is sent. * * @name ajaxSend * @type jQuery * @param Function callback The function to execute. - * @cat AJAX + * @cat Ajax */ - -new function(){ - var e = "ajaxStart,ajaxStop,ajaxComplete,ajaxError,ajaxSuccess,ajaxSend".split(","); - - for ( var i = 0; i < e.length; i++ ) new function(){ - var o = e[i]; - jQuery.fn[o] = function(f){ - return this.bind(o, f); - }; +jQuery.each( "ajaxStart,ajaxStop,ajaxComplete,ajaxError,ajaxSuccess,ajaxSend".split(","), function(i,o){ + jQuery.fn[o] = function(f){ + return this.bind(o, f); }; -}; +}); jQuery.extend({ @@ -277,14 +269,15 @@ jQuery.extend({ * @param String url The URL of the page to load. * @param Map params (optional) Key/value pairs that will be sent to the server. * @param Function callback (optional) A function to be executed whenever the data is loaded. - * @cat AJAX + * @cat Ajax */ get: function( url, data, callback, type, ifModified ) { // shift arguments if data argument was ommited - if ( data && data.constructor == Function ) { + if ( jQuery.isFunction( data ) ) { callback = data; data = null; } + return jQuery.ajax({ url: url, data: data, @@ -318,7 +311,7 @@ jQuery.extend({ * @param String url The URL of the page to load. * @param Map params (optional) Key/value pairs that will be sent to the server. * @param Function callback (optional) A function to be executed whenever the data is loaded. - * @cat AJAX + * @cat Ajax */ getIfModified: function( url, data, callback, type ) { return jQuery.get(url, data, callback, type, 1); @@ -341,7 +334,7 @@ jQuery.extend({ * @type XMLHttpRequest * @param String url The URL of the page to load. * @param Function callback (optional) A function to be executed whenever the data is loaded. - * @cat AJAX + * @cat Ajax */ getScript: function( url, callback ) { return jQuery.get(url, null, callback, "script"); @@ -366,7 +359,7 @@ jQuery.extend({ * @param String url The URL of the page to load. * @param Map params (optional) Key/value pairs that will be sent to the server. * @param Function callback A function to be executed whenever the data is loaded. - * @cat AJAX + * @cat Ajax */ getJSON: function( url, data, callback ) { return jQuery.get(url, data, callback, "json"); @@ -395,7 +388,7 @@ jQuery.extend({ * @param String url The URL of the page to load. * @param Map params (optional) Key/value pairs that will be sent to the server. * @param Function callback (optional) A function to be executed whenever the data is loaded. - * @cat AJAX + * @cat Ajax */ post: function( url, data, callback, type ) { return jQuery.ajax({ @@ -428,9 +421,9 @@ jQuery.extend({ * @name $.ajaxTimeout * @type undefined * @param Number time How long before an AJAX request times out. - * @cat AJAX + * @cat Ajax */ - ajaxTimeout: function(timeout) { + ajaxTimeout: function( timeout ) { jQuery.ajaxSettings.timeout = timeout; }, @@ -452,10 +445,10 @@ jQuery.extend({ * @name $.ajaxSetup * @type undefined * @param Map settings Key/value pairs to use for all AJAX requests - * @cat AJAX + * @cat Ajax */ - ajaxSetup: function(settings) { - jQuery.extend(jQuery.ajaxSettings, settings); + ajaxSetup: function( settings ) { + jQuery.extend( jQuery.ajaxSettings, settings ); }, ajaxSettings: { @@ -464,7 +457,8 @@ jQuery.extend({ timeout: 0, contentType: "application/x-www-form-urlencoded", processData: true, - async: true + async: true, + data: null }, // Last-Modified header cache for next request @@ -543,7 +537,7 @@ jQuery.extend({ * the default content-type "application/x-www-form-urlencoded". If you want to send * DOMDocuments, set this option to false. * - * (Boolean) async - By default, all requests are send asynchronous (set to true). + * (Boolean) async - By default, all requests are sent asynchronous (set to true). * If you need synchronous requests, set this option to false. * * (Function) beforeSend - A pre-callback to set custom headers etc., the @@ -587,7 +581,7 @@ jQuery.extend({ * @name $.ajax * @type XMLHttpRequest * @param Map properties Key/value pairs to initialize the request with. - * @cat AJAX + * @cat Ajax * @see ajaxSetup(Map) */ ajax: function( s ) { @@ -597,7 +591,7 @@ jQuery.extend({ // if data available if ( s.data ) { // convert data if not already a string - if (s.processData && typeof s.data != 'string') + if (s.processData && typeof s.data != "string") s.data = jQuery.param(s.data); // append data to url for get requests if( s.type.toLowerCase() == "get" ) @@ -636,7 +630,8 @@ jQuery.extend({ // Allow custom headers/mimetypes if( s.beforeSend ) s.beforeSend(xml); - if (s.global) + + if ( s.global ) jQuery.event.trigger("ajaxSend", [xml, s]); // Wait for a response to come back @@ -669,9 +664,8 @@ jQuery.extend({ // Fire the global callback if( s.global ) jQuery.event.trigger( "ajaxSuccess", [xml, s] ); - } else { + } else jQuery.handleError(s, xml, status); - } } catch(e) { status = "error"; jQuery.handleError(s, xml, status, e); @@ -686,7 +680,8 @@ jQuery.extend({ jQuery.event.trigger( "ajaxStop" ); // Process result - if ( s.complete ) s.complete(xml, status); + if ( s.complete ) + s.complete(xml, status); // Stop memory leaks xml.onreadystatechange = function(){}; @@ -696,10 +691,10 @@ jQuery.extend({ xml.onreadystatechange = onreadystatechange; // Timeout checker - if(s.timeout > 0) + if ( s.timeout > 0 ) setTimeout(function(){ // Check to see if the request is still happening - if(xml) { + if ( xml ) { // Cancel the request xml.abort(); @@ -719,19 +714,19 @@ jQuery.extend({ } // firefox 1.5 doesn't fire statechange for sync requests - if(!s.async) + if ( !s.async ) onreadystatechange(); // return XMLHttpRequest to allow aborting the request etc. return xml2; }, - handleError: function(s, xml, status, e) { + handleError: function( s, xml, status, e ) { // If a local callback was specified, fire it if ( s.error ) s.error( xml, status, e ); // Fire the global callback - if( s.global ) + if ( s.global ) jQuery.event.trigger( "ajaxError", [xml, s, e] ); }, @@ -739,7 +734,7 @@ jQuery.extend({ active: 0, // Determines if an XMLHttpRequest was successful or not - httpSuccess: function(r) { + httpSuccess: function( r ) { try { return !r.status && location.protocol == "file:" || ( r.status >= 200 && r.status < 300 ) || r.status == 304 || @@ -749,7 +744,7 @@ jQuery.extend({ }, // Determines if an XMLHttpRequest returns NotModified - httpNotModified: function(xml, url) { + httpNotModified: function( xml, url ) { try { var xmlRes = xml.getResponseHeader("Last-Modified"); @@ -766,51 +761,50 @@ jQuery.extend({ * (String) data - The type of data that you're expecting back, * (e.g. "xml", "html", "script") */ - httpData: function(r,type) { + httpData: function( r, type ) { var ct = r.getResponseHeader("content-type"); var data = !type && ct && ct.indexOf("xml") >= 0; data = type == "xml" || data ? r.responseXML : r.responseText; // If the type is "script", eval it in global context - if ( type == "script" ) { + if ( type == "script" ) jQuery.globalEval( data ); - } // Get the JavaScript object, if JSON is used. - if ( type == "json" ) eval( "data = " + data ); + if ( type == "json" ) + eval( "data = " + data ); // evaluate scripts within html - if ( type == "html" ) jQuery("
    ").html(data).evalScripts(); + if ( type == "html" ) + jQuery("
    ").html(data).evalScripts(); return data; }, // Serialize an array of form elements or a set of // key/values into a query string - param: function(a) { + param: function( a ) { var s = []; // If an array was passed in, assume that it is an array // of form elements - if ( a.constructor == Array || a.jquery ) { + if ( a.constructor == Array || a.jquery ) // Serialize the form elements - for ( var i = 0; i < a.length; i++ ) - s.push( a[i].name + "=" + encodeURIComponent( a[i].value ) ); + jQuery.each( a, function(){ + s.push( encodeURIComponent(this.name) + "=" + encodeURIComponent( this.value ) ); + }); // Otherwise, assume that it's an object of key/value pairs - } else { + else // Serialize the key/values - for ( var j in a ) { + for ( var j in a ) // If the value is an array then the key names need to be repeated - if( a[j].constructor == Array ) { - for (var k = 0; k < a[j].length; k++) { - s.push( j + "=" + encodeURIComponent( a[j][k] ) ); - } - } else { - s.push( j + "=" + encodeURIComponent( a[j] ) ); - } - } - } + if ( a[j].constructor == Array ) + jQuery.each( a[j], function(){ + s.push( encodeURIComponent(j) + "=" + encodeURIComponent( this ) ); + }); + else + s.push( encodeURIComponent(j) + "=" + encodeURIComponent( a[j] ) ); // Return the resulting serialization return s.join("&"); @@ -818,10 +812,10 @@ jQuery.extend({ // evalulates a script in global context // not reliable for safari - globalEval: function(data) { - if (window.execScript) + globalEval: function( data ) { + if ( window.execScript ) window.execScript( data ); - else if(jQuery.browser.safari) + else if ( jQuery.browser.safari ) // safari doesn't provide a synchronous global eval window.setTimeout( data, 0 ); else