jQuery 在非同步提交方面的封裝做得相當完善。若直接使用原生 AJAX 會非常繁瑣,而 jQuery 大幅簡化了我們的操作,也不需再煩惱瀏覽器之間的差異。
$.post、$.get 是一些簡單的方法,若要處理複雜邏輯,仍需使用 jQuery.ajax()。
一、$.ajax 的一般格式
$.ajax({
type: 'POST',
url: url,
data: data,
success: success,
dataType: dataType
});
二、$.ajax 的參數說明
url:必需。規定把請求發送到哪個 URL。
data:可選。映射或字串值。規定連同請求發送到伺服器的資料。
success(data, textStatus, jqXHR):可選。請求成功時執行的回呼函式。
dataType:可選。規定預期的伺服器回應資料型別,預設會智慧判斷(xml、json、script 或 html)。
三、$.ajax 需要注意的地方:
1. data 主要有三種形式:HTML 拼接、JSON 陣列,以及表單經 serialize() 序列化後的字串;可透過 dataType 指定,不指定則智慧判斷。
2. $.ajax 只能以文字方式提交 form,若包含 <file> 上傳則傳送不過去,需使用 jquery.form.js 的 $.ajaxSubmit。
四、$.ajax 的實際應用範例
// $.ajax 帶 json 資料的非同步請求
var aj = $.ajax({
url: 'productManager_reverseUpdate', // 跳轉到 action
data: {
selRollBack: selRollBack,
selOperatorsCode: selOperatorsCode,
PROVINCECODE: PROVINCECODE,
pass: pass
},
type: 'post',
cache: false,
dataType: 'json',
success: function (data) {
if (data.msg == "true") {
alert("修改成功!");
window.location.reload();
} else {
view(data.msg);
}
},
error: function () {
alert("異常!");
}
});
// $.ajax 序列化表格內容為字串的非同步請求
function noTips() {
var formParam = $("#form").serialize(); // 序列化表格內容為字串
$.ajax({
type: 'post',
url: 'Notice_noTipsNotice',
data: formParam,
cache: false,
dataType: 'json',
success: function (data) {}
});
}
// $.ajax 拼接 url 的非同步請求
var yz = $.ajax({
type: 'post',
url: 'validatePwd_checkPwd?password=' + password,
data: {},
cache: false,
dataType: 'json',
success: function (data) {
if (data.msg == "false") // 伺服器返回 false,就將 validatePassword 的值改為 pwdError
{
textPassword.html("<font color='red'>業務密碼不正確!</font>");
$("#validatePassword").val("pwdError");
checkPassword = false;
return;
}
},
error: function () {}
});
// $.ajax 拼接 data 的非同步請求
$.ajax({
url: '<%=request.getContextPath()%>/kc/kc_checkMerNameUnique.action',
type: 'post',
data: 'merName=' + values,
async: false, // 預設為 true 非同步
error: function () { alert('error'); },
success: function (data) {
$("#" + divs).html(data);
}
});
以下說明 $.ajax() 提供的一眾參數,因此它能實現相當複雜的功能:
url(String,預設:當前頁位址)發送請求的位址。
type(String,預設:"GET")請求方式("POST" 或 "GET")。注意:其他 HTTP 請求方法如 PUT、DELETE 也可使用,但僅部分瀏覽器支援。
timeout(Number)設定請求逾時時間(毫秒),此設定將覆蓋全域設定。
async(Boolean,預設:true)預設所有請求皆為非同步;若需發送同步請求,請設為 false。注意同步請求會鎖住瀏覽器,用戶其他操作須等待請求完成才可執行。
beforeSend(Function)發送請求前可修改 XMLHttpRequest 物件的函式,如添加自訂 HTTP 標頭,XMLHttpRequest 物件為唯一參數。
cache(Boolean,預設:true)設為 false 將不會從瀏覽器緩存中載入請求資訊。
complete(Function)請求完成後回呼函式(成功或失敗時皆會呼叫),參數為 XMLHttpRequest 物件與成功資訊字串。
contentType(String,預設:"application/x-www-form-urlencoded")發送資訊至伺服器時的內容編碼型別,預設值適合大多數場合。
data(Object 或 String)發送到伺服器的資料,將自動轉換為請求字串格式,GET 請求中會附加在 URL 後。必須為 Key/Value 格式;若為陣列,jQuery 會自動為不同值對應同一個名稱,如 {foo:["bar1","bar2"]} 轉換為 '&foo=bar1&foo=bar2'。
dataType(String)預期伺服器返回的資料型別。若不指定,jQuery 會自動根據 HTTP 包 MIME 資訊返回 responseXML 或 responseText。可用值:xml(返回 XML 文件)、html(返回純文字 HTML)、script(返回純文字 JavaScript 程式碼,不會自動緩存結果)、json(返回 JSON 資料)、jsonp(JSONP 格式,如 "myurl?callback=?" jQuery 會自動替換 ? 為正確的函數名)。
error(Function)請求失敗時呼叫,有三個參數:XMLHttpRequest 物件、錯誤資訊、捕獲的錯誤物件(通常 textStatus 與 errorThrown 只有其中一個有值)。
global(Boolean,預設:true)是否觸發全域 AJAX 事件,設為 false 將不觸發如 ajaxStart 或 ajaxStop 等事件。
ifModified(Boolean,預設:false)僅在伺服器資料改變時取得新資料,使用 HTTP 包 Last-Modified 標頭判斷。
processData(Boolean,預設:true)預設會將發送的資料轉換為物件以配合預設內容型別 "application/x-www-form-urlencoded";若要發送 DOM 樹資訊或不希望轉換的資訊,請設為 false。
success(Function)請求成功後回呼函式,有兩個參數:伺服器返回資料與返回狀態。
以上便是本文為大家介紹的 jQuery Ajax 實例詳解,希望對大家學習 jQuery Ajax 有所幫助。