jQuery.ajaxSetup()函數的用法實例詳解

jQuery.ajaxSetup()函數用於設定AJAX的全域預設設定。

此函數用於更改jQuery中AJAX請求的預設選項。之後執行的所有AJAX請求，如果對應的選項參數沒有設置，則會使用更改後的預設設定。

該函數屬於全域jQuery物件。

語法

jQuery 1.1 新增該靜態函數。

jQuery.ajaxSetup( settings )

參數

參數 描述

settings Object類別型一個對象，其中的每個屬性表示需要更改預設設定的選項，屬性值表示更改後的預設值。

關於settings參數可以辨識的屬性，請參考jQuery.ajax()中的settings參數說明。其中的所有選項參數都是可選設定的。

傳回值

jQuery.ajaxSetup()函數沒有傳回值，或說其傳回值為undefined。

範例&說明

以下是與jQuery.ajaxSetup()函數相關的jQuery範例程式碼，以示範jQuery.ajaxSetup()函數的具體用法：

//设置AJAX的全局默认选项
$.ajaxSetup( {
    url: "/index.html" , // 默认URL
    aysnc: false , // 默认同步加载
    type: "POST" , // 默认使用POST方式
    headers: { // 默认添加请求头
        "Author": "CodePlayer" ,
        "Powered-By": "CodePlayer"
    } ,
    error: function(jqXHR, textStatus, errorMsg){ // 出错时默认的处理函数
        // jqXHR 是经过jQuery封装的XMLHttpRequest对象
        // textStatus 可能为： null、"timeout"、"error"、"abort"或"parsererror"
        // errorMsg 可能为： "Not Found"、"Internal Server Error"等
        // 提示形如：发送AJAX请求到"/index.html"时出错[404]：Not Found
        alert( '发送AJAX请求到"' + this.url + '"时出错[' + jqXHR.status + ']：' + errorMsg );        
    }
} );
// 未设置任何参数，但url、async、type、headers、error等参数的默认值均已被$.ajaxSetup()更改(如上)
$.ajax( );
// 设置了url、type、success、error，就使用自己设置的参数值
// 但async、headers等参数的默认值已被$.ajaxSetup()更改
$.ajax( {
    url: "myurl.php?action=list" ,
    type: "GET" ,
    success: function( data, textStatus, jqXHR ){
        alert("返回数据：" + data);
    } ,
    error: function(jqXHR, textStatus, errorMsg){
        alert("自己的error!");        
    }
});
// 上述$.ajaxSetup()的默认设置对$.get()、$.post()、load()、$.getJSON()、$.getScript()等AJAX函数也生效
// 因为这些函数也是在内部调用$.ajax()函数来实现的，只不过它们在内部都设置了一些参数
// $.get()在内部调用$.ajax()时已设置type为"GET"，因此仍然使用GET方式。
// 但url、async、headers、error等参数的默认值已被$.ajaxSetup()更改
$.get( );
// $.post()在内部调用$.ajax()时已设置type为"POST"，因此仍然使用POST方式。
// url也被设置为"user/action.php?method=addUser"
// 但async、headers、error等参数的默认值已被$.ajaxSetup()更改
$.post( "user/action.php?method=addUser" );

以上是jQuery.ajaxSetup()函數的用法實例詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章！