options(可選)ObjectAJAX 請求設置。所有選項都是可選的。 asyncBoolean
(默認: true) 默認設置下,所有請求均為異步請求。如果需要發送同步請求,請將此選項設置為 false。註意,同步請求將鎖住瀏覽器,用戶其它操作必須等待請求完成才可以執行。
beforeSend(XHR)Function
發送請求前可修改 XMLHttpRequest 對象的函數,如添加自定義 HTTP 頭。XMLHttpRequest 對象是唯壹的參數。這是壹個 Ajax 事件。如果返回false可以取消本次ajax請求。
function (XMLHttpRequest) { this; // 調用本次AJAX請求時傳遞的options參數}cacheBoolean(默認: true,dataType為script和jsonp時默認為false) jQuery 1.2 新功能,設置為 false 將不緩存此頁面。
complete(XHR, TS)Function
請求完成後回調函數 (請求成功或失敗之後均調用)。參數: XMLHttpRequest 對象和壹個描述成功請求類型的字符串。 Ajax 事件。
function (XMLHttpRequest, textStatus) { this; // 調用本次AJAX請求時傳遞的options參數}contentTypeString(默認: application/x-www-form-urlencoded) 發送信息至服務器時內容編碼類型。默認值適合大多數情況。如果妳明確地傳遞了壹個content-type給 $.ajax() 那麽他必定會發送給服務器(即使沒有數據要發送)
contextObject
這個對象用於設置Ajax相關回調函數的上下文。也就是說,讓回調函數內this指向這個對象(如果不設定這個參數,那麽this就指向調用本次AJAX請求時傳遞的options參數)。比如指定壹個DOM元素作為context參數,這樣就設置了success回調函數的上下文為這個DOM元素。就像這樣:
$.ajax({ url: test.html, context: document.body, success: function(){ $(this).addClass(done);}});
dataObject,String
發送到服務器的數據。將自動轉換為請求字符串格式。GET 請求中將附加在 URL 後。查看 processData 選項說明以禁止此自動轉換。必須為 Key/Value 格式。如果為數組,jQuery 將自動為不同值對應同壹個名稱。如 {foo:[bar1, bar2]} 轉換為 '&foo=bar1&foo=bar2'。
dataFilterFunction
給Ajax返回的原始數據的進行預處理的函數。提供data和type兩個參數:data是Ajax返回的原始數據,type是調用jQuery.ajax時提供的dataType參數。函數返回的值將由jQuery進壹步處理。
function (data, type) { // 對Ajax返回的原始數據進行預處理 return data // 返回處理後的數據}dataTypeString預期服務器返回的數據類型。如果不指定,jQuery 將自動根據 HTTP 包 MIME 信息來智能判斷,比如XML MIME類型就被識別為XML。在1.4中,JSON就會生成壹個JavaScript對象,而script則會執行這個腳本。隨後服務器端返回的數據會根據這個值解析後,傳遞給回調函數。可用值:
xml: 返回 XML 文檔,可用 jQuery 處理。
html: 返回純文本 HTML 信息;包含的script標簽會在插入dom時執行。
script: 返回純文本 JavaScript 代碼。不會自動緩存結果。除非設置了cache參數。'''註意:'''在遠程請求時(不在同壹個域下),所有POST請求都將轉為GET請求。(因為將使用DOM的script標簽來加載)
json: 返回 JSON 數據 。
jsonp: JSONP 格式。使用 JSONP 形式調用函數時,如 myurl?callback=? jQuery 將自動替換 ? 為正確的函數名,以執行回調函數。
text: 返回純文本字符串
errorFunction
(默認: 自動判斷 (xml 或 html)) 請求失敗時調用此函數。有以下三個參數:XMLHttpRequest 對象、錯誤信息、(可選)捕獲的異常對象。如果發生了錯誤,錯誤信息(第二個參數)除了得到null之外,還可能是timeout, error, notmodified 和 parsererror。Ajax 事件。
function (XMLHttpRequest, textStatus, errorThrown) { // 通常 textStatus 和 errorThrown 之中 // 只有壹個會包含信息 this; // 調用本次AJAX請求時傳遞的options參數}globalBoolean(默認: true) 是否觸發全局 AJAX 事件。設置為 false 將不會觸發全局 AJAX 事件,如 ajaxStart 或 ajaxStop 可用於控制不同的 Ajax 事件。
ifModifiedBoolean
(默認: false) 僅在服務器數據改變時獲取新數據。使用 HTTP 包 Last-Modified 頭信息判斷。在jQuery 1.4中,他也會檢查服務器指定的'etag'來確定數據沒有被修改過。
jsonpString在壹個jsonp請求中重寫回調函數的名字。這個值用來替代在callback=?這種GET或POST請求中URL參數裏的callback部分,比如{jsonp:'onJsonPLoad'}會導致將onJsonPLoad=?傳給服務器。
jsonpCallbackString為jsonp請求指定壹個回調函數名。這個值將用來取代jQuery自動生成的隨機函數名。這主要用來讓jQuery生成度獨特的函數名,這樣管理請求更容易,也能方便地提供回調函數和錯誤處理。妳也可以在想讓瀏覽器緩存GET請求的時候,指定這個回調函數名。
passwordString
用於響應HTTP訪問認證請求的密碼
processDataBoolean
(默認: true) 默認情況下,通過data選項傳遞進來的數據,如果是壹個對象(技術上講只要不是字符串),都會處理轉化成壹個查詢字符串,以配合默認內容類型 application/x-www-form-urlencoded。如果要發送 DOM 樹信息或其它不希望轉換的信息,請設置為 false。
scriptCharsetString
只有當請求時dataType為jsonp或script,並且type是GET才會用於強制修改charset。通常只在本地和遠程的內容編碼不同時使用。
successFunction
請求成功後的回調函數。參數:由服務器返回,並根據dataType參數進行處理後的數據;描述狀態的字符串。 Ajax 事件。
function (data, textStatus) { // data 可能是 xmlDoc, jsonObj, html, text, 等等... this; // 調用本次AJAX請求時傳遞的options參數}
traditionalBoolean
如果妳想要用傳統的方式來序列化數據,那麽就設置為true。請參考工具分類下面的jQuery.param 方法。
timeoutNumber
設置請求超時時間(毫秒)。此設置將覆蓋全局設置。
typeString
(默認: GET) 請求方式 (POST 或 GET), 默認為 GET。註意:其它 HTTP 請求方法,如 PUT 和 DELETE 也可以使用,但僅部分瀏覽器支持。
urlString
(默認: 當前頁地址) 發送請求的地址。
usernameString
用於響應HTTP訪問認證請求的用戶名
xhrFunction
需要返回壹個XMLHttpRequest 對象。默認在IE下是ActiveXObject 而其他情況下是XMLHttpRequest 。用於重寫或者提供壹個增強的XMLHttpRequest 對象。這個參數在jQuery 1.3以前不可用。 描述:加載並執行壹個 JS 文件。
jQuery 代碼:$.ajax({ type: GET, url: test.js, dataType: script});
描述:
保存數據到服務器,成功時顯示信息。
jQuery 代碼:$.ajax({ type: POST, url: some.php, data: name=John&location=Boston, success: function(msg){ alert( Data Saved: + msg ); }});
描述:
裝入壹個 HTML 網頁最新版本。
jQuery 代碼:$.ajax({ url: test.html, cache: false, success: function(html){ $(#results).append(html); }});
描述:
同步加載數據。發送請求時鎖住瀏覽器。需要鎖定用戶交互操作時使用同步方式。
jQuery 代碼: var html = $.ajax({ url: some.php, async: false }).responseText;
描述:
發送 XML 數據至服務器。設置 processData 選項為 false,防止自動轉換數據格式。
jQuery 代碼:
var xmlDocument = [create xml document]; $.ajax({ url: page.php, processData: false, data: xmlDocument, success: handleResponse });
jQuery post實例代碼:
$.post(test.php,{name:name,pwd:pwd},function(msg){
alert(msg);
})
test.php 裏面用$_POST[name] 和$_POST[pwd]接收參數.
$.post第壹個參數是url,{}這裏裏面的是參數名稱和值之間用:非開,多個值用,分開,最後壹個是返回的函數msg就是返回的結果。根據自己的需要返回不用的數據。
$.get和post壹樣,php接收的話改成$_GET[name]和$_GET[pwd]