男女疯狂一边摸一边做羞羞视频|啊好深好硬快点用力别停动态图|亚洲一区无码中文字幕|特级无码毛片免费视频播放▽|久久狠狠躁免费观看|国内精品久久久久久网站

首頁(yè)  >  ajax  > $.ajax(url,[settings])

返回值:XMLHttpRequestjQuery.ajax(url,[settings])

jQuery $.ajax() 方法概述

通過(guò) HTTP 請求加載遠程數據。

jQuery 底層 AJAX 實(shí)現。簡(jiǎn)單易用的高層實(shí)現見(jiàn) $.get, $.post 等。$.ajax() 返回其創(chuàng )建的 XMLHttpRequest 對象。大多數情況下你無(wú)需直接操作該函數,除非你需要操作不常用的選項,以獲得更多的靈活性。

最簡(jiǎn)單的情況下,$.ajax()可以不帶任何參數直接使用。

注意,所有的選項都可以通過(guò)$.ajaxSetup()函數來(lái)全局設置。

回調函數

如果要處理$.ajax()得到的數據,則需要使用回調函數。beforeSend、error、dataFilter、success、complete。

  • beforeSend 在發(fā)送請求之前調用,并且傳入一個(gè)XMLHttpRequest作為參數。
  • error 在請求出錯時(shí)調用。傳入XMLHttpRequest對象,描述錯誤類(lèi)型的字符串以及一個(gè)異常對象(如果有的話(huà))
  • dataFilter 在請求成功之后調用。傳入返回的數據以及"dataType"參數的值。并且必須返回新的數據(可能是處理過(guò)的)傳遞給success回調函數。
  • success 當請求之后調用。傳入返回后的數據,以及包含成功代碼的字符串。
  • complete 當請求完成之后調用這個(gè)函數,無(wú)論成功或失敗。傳入XMLHttpRequest對象,以及一個(gè)包含成功或錯誤代碼的字符串。

數據類(lèi)型

$.ajax()函數依賴(lài)服務(wù)器提供的信息來(lái)處理返回的數據。如果服務(wù)器報告說(shuō)返回的數據是XML,那么返回的結果就可以用普通的XML方法或者jQuery的選擇器來(lái)遍歷。如果見(jiàn)得到其他類(lèi)型,比如HTML,則數據就以文本形式來(lái)對待。

通過(guò)dataType選項還可以指定其他不同數據處理方式。除了單純的XML,還可以指定 html、json、jsonp、script或者text。

其中,text和xml類(lèi)型返回的數據不會(huì )經(jīng)過(guò)處理。數據僅僅簡(jiǎn)單的將XMLHttpRequest的responseText或responseHTML屬性傳遞給success回調函數,

'''注意''',我們必須確保網(wǎng)頁(yè)服務(wù)器報告的MIME類(lèi)型與我們選擇的dataType所匹配。比如說(shuō),XML的話(huà),服務(wù)器端就必須聲明 text/xml 或者 application/xml 來(lái)獲得一致的結果。

如果指定為html類(lèi)型,任何內嵌的JavaScript都會(huì )在HTML作為一個(gè)字符串返回之前執行。類(lèi)似的,指定script類(lèi)型的話(huà),也會(huì )先執行服務(wù)器端生成JavaScript,然后再把腳本作為一個(gè)文本數據返回。

如果指定為json類(lèi)型,則會(huì )把獲取到的數據作為一個(gè)JavaScript對象來(lái)解析,并且把構建好的對象作為結果返回。為了實(shí)現這個(gè)目的,他首先嘗試使用JSON.parse()。如果瀏覽器不支持,則使用一個(gè)函數來(lái)構建。JSON數據是一種能很方便通過(guò)JavaScript解析的結構化數據。如果獲取的數據文件存放在遠程服務(wù)器上(域名不同,也就是跨域獲取數據),則需要使用jsonp類(lèi)型。使用這種類(lèi)型的話(huà),會(huì )創(chuàng )建一個(gè)查詢(xún)字符串參數 callback=? ,這個(gè)參數會(huì )加在請求的URL后面。服務(wù)器端應當在JSON數據前加上回調函數名,以便完成一個(gè)有效的JSONP請求。如果要指定回調函數的參數名來(lái)取代默認的callback,可以通過(guò)設置$.ajax()的jsonp參數。

注意,JSONP是JSON格式的擴展。他要求一些服務(wù)器端的代碼來(lái)檢測并處理查詢(xún)字符串參數。更多信息可以參閱 最初的文章。

如果指定了script或者jsonp類(lèi)型,那么當從服務(wù)器接收到數據時(shí),實(shí)際上是用了<script>標簽而不是XMLHttpRequest對象。這種情況下,$.ajax()不再返回一個(gè)XMLHttpRequest對象,并且也不會(huì )傳遞事件處理函數,比如beforeSend。

發(fā)送數據到服務(wù)器

默認情況下,Ajax請求使用GET方法。如果要使用POST方法,可以設定type參數值。這個(gè)選項也會(huì )影響data選項中的內容如何發(fā)送到服務(wù)器。

data選項既可以包含一個(gè)查詢(xún)字符串,比如 key1=value1&key2=value2 ,也可以是一個(gè)映射,比如 {key1: 'value1', key2: 'value2'} 。如果使用了后者的形式,則數據再發(fā)送器會(huì )被轉換成查詢(xún)字符串。這個(gè)處理過(guò)程也可以通過(guò)設置processData選項為false來(lái)回避。如果我們希望發(fā)送一個(gè)XML對象給服務(wù)器時(shí),這種處理可能并不合適。并且在這種情況下,我們也應當改變contentType選項的值,用其他合適的MIME類(lèi)型來(lái)取代默認的 application/x-www-form-urlencoded 。

高級選項

global選項用于阻止響應注冊的回調函數,比如.ajaxSend,或者ajaxError,以及類(lèi)似的方法。這在有些時(shí)候很有用,比如發(fā)送的請求非常頻繁且簡(jiǎn)短的時(shí)候,就可以在ajaxSend里禁用這個(gè)。更多關(guān)于這些方法的詳細信息,請參閱下面的內容。

如果服務(wù)器需要HTTP認證,可以使用用戶(hù)名和密碼可以通過(guò)username和password選項來(lái)設置。

Ajax請求是限時(shí)的,所以錯誤警告被捕獲并處理后,可以用來(lái)提升用戶(hù)體驗。請求超時(shí)這個(gè)參數通常就保留其默認值,要不就通過(guò)jQuery.ajaxSetup來(lái)全局設定,很少為特定的請求重新設置timeout選項。

默認情況下,請求總會(huì )被發(fā)出去,但瀏覽器有可能從他的緩存中調取數據。要禁止使用緩存的結果,可以設置cache參數為false。如果希望判斷數據自從上次請求后沒(méi)有更改過(guò)就報告出錯的話(huà),可以設置ifModified為true。

scriptCharset允許給<script>標簽的請求設定一個(gè)特定的字符集,用于script或者jsonp類(lèi)似的數據。當腳本和頁(yè)面字符集不同時(shí),這特別好用。

Ajax的第一個(gè)字母是asynchronous的開(kāi)頭字母,這意味著(zhù)所有的操作都是并行的,完成的順序沒(méi)有前后關(guān)系。$.ajax()的async參數總是設置成true,這標志著(zhù)在請求開(kāi)始后,其他代碼依然能夠執行。強烈不建議把這個(gè)選項設置成false,這意味著(zhù)所有的請求都不再是異步的了,這也會(huì )導致瀏覽器被鎖死。

$.ajax函數返回他創(chuàng )建的XMLHttpRequest對象。通常jQuery只在內部處理并創(chuàng )建這個(gè)對象,但用戶(hù)也可以通過(guò)xhr選項來(lái)傳遞一個(gè)自己創(chuàng )建的xhr對象。返回的對象通常已經(jīng)被丟棄了,但依然提供一個(gè)底層接口來(lái)觀(guān)察和操控請求。比如說(shuō),調用對象上的.abort()可以在請求完成前掛起請求。

參數

url,[settings]ObjectV1.5

url:一個(gè)用來(lái)包含發(fā)送請求的URL字符串。

settings:AJAX 請求設置。所有選項都是可選的。

V1.0settings:選項

acceptsMap

默認: 取決于數據類(lèi)型。

內容類(lèi)型發(fā)送請求頭,告訴服務(wù)器什么樣的響應會(huì )接受返回。如果accepts設置需要修改,推薦在$.ajaxSetup()方法中做一次。

asyncBoolean

(默認: true) 默認設置下,所有請求均為異步請求。如果需要發(fā)送同步請求,請將此選項設置為 false。注意,同步請求將鎖住瀏覽器,用戶(hù)其它操作必須等待請求完成才可以執行。

beforeSend(XHR)Function

發(fā)送請求前可修改 XMLHttpRequest 對象的函數,如添加自定義 HTTP 頭。XMLHttpRequest 對象是唯一的參數。這是一個(gè) Ajax 事件。如果返回false可以取消本次ajax請求。

function (XMLHttpRequest) {
    this; // 調用本次AJAX請求時(shí)傳遞的options參數
}

cacheBoolean

(默認: true,dataType為script和jsonp時(shí)默認為false) jQuery 1.2 新功能,設置為 false 將不緩存此頁(yè)面。

complete(XHR, TS)Function

請求完成后回調函數 (請求成功或失敗之后均調用)。參數: XMLHttpRequest 對象和一個(gè)描述成功請求類(lèi)型的字符串。 Ajax 事件。

function (XMLHttpRequest, textStatus) {
    this; // 調用本次AJAX請求時(shí)傳遞的options參數
}

contentsMapV1.5

一個(gè)以"{字符串:正則表達式}"配對的對象,用來(lái)確定jQuery將如何解析響應,給定其內容類(lèi)型。

contentTypeString

(默認: "application/x-www-form-urlencoded") 發(fā)送信息至服務(wù)器時(shí)內容編碼類(lèi)型。默認值適合大多數情況。如果你明確地傳遞了一個(gè)content-type給 $.ajax() 那么他必定會(huì )發(fā)送給服務(wù)器(即使沒(méi)有數據要發(fā)送)

contextObject

這個(gè)對象用于設置Ajax相關(guān)回調函數的上下文。也就是說(shuō),讓回調函數內this指向這個(gè)對象(如果不設定這個(gè)參數,那么this就指向調用本次AJAX請求時(shí)傳遞的options參數)。比如指定一個(gè)DOM元素作為context參數,這樣就設置了success回調函數的上下文為這個(gè)DOM元素。就像這樣:

$.ajax({ url: "test.html", context: document.body, success: function(){
    $(this).addClass("done");
}});

convertersmapV1.5

默認: {"* text": window.String, "text html": true, "text json": jQuery.parseJSON, "text xml": jQuery.parseXML}

一個(gè)數據類(lèi)型對數據類(lèi)型轉換器的對象。每個(gè)轉換器的值是一個(gè)函數,返回響應的轉化值

crossDomainmapV1.5

默認: 同域請求為false

跨域請求為true如果你想強制跨域請求(如JSONP形式)同一域,設置crossDomain為true。這使得例如,服務(wù)器端重定向到另一個(gè)域

dataObject,String

發(fā)送到服務(wù)器的數據。將自動(dòng)轉換為請求字符串格式。GET 請求中將附加在 URL 后。查看 processData 選項說(shuō)明以禁止此自動(dòng)轉換。必須為 Key/Value 格式。如果為數組,jQuery 將自動(dòng)為不同值對應同一個(gè)名稱(chēng)。如 {foo:["bar1", "bar2"]} 轉換為 "&foo=bar1&foo=bar2"。

dataFilterFunction

給Ajax返回的原始數據的進(jìn)行預處理的函數。提供data和type兩個(gè)參數:data是Ajax返回的原始數據,type是調用jQuery.ajax時(shí)提供的dataType參數。函數返回的值將由jQuery進(jìn)一步處理。

function (data, type) {
    // 對Ajax返回的原始數據進(jìn)行預處理
    return data  // 返回處理后的數據
}

dataTypeString

預期服務(wù)器返回的數據類(lèi)型。如果不指定,jQuery 將自動(dòng)根據 HTTP 包 MIME 信息來(lái)智能判斷,比如XML MIME類(lèi)型就被識別為XML。在1.4中,JSON就會(huì )生成一個(gè)JavaScript對象,而script則會(huì )執行這個(gè)腳本。隨后服務(wù)器端返回的數據會(huì )根據這個(gè)值解析后,傳遞給回調函數??捎弥?

"xml": 返回 XML 文檔,可用 jQuery 處理。

"html": 返回純文本 HTML 信息;包含的script標簽會(huì )在插入dom時(shí)執行。

"script": 返回純文本 JavaScript 代碼。不會(huì )自動(dòng)緩存結果。除非設置了"cache"參數。'''注意:'''在遠程請求時(shí)(不在同一個(gè)域下),所有POST請求都將轉為GET請求。(因為將使用DOM的script標簽來(lái)加載)

"json": 返回 JSON 數據 。

"jsonp": JSONP 格式。使用 JSONP 形式調用函數時(shí),如 "myurl?callback=?" jQuery 將自動(dòng)替換 ? 為正確的函數名,以執行回調函數。

"text": 返回純文本字符串

errorFunction

(默認: 自動(dòng)判斷 (xml 或 html)) 請求失敗時(shí)調用此函數。有以下三個(gè)參數:XMLHttpRequest 對象、錯誤信息、(可選)捕獲的異常對象。如果發(fā)生了錯誤,錯誤信息(第二個(gè)參數)除了得到null之外,還可能是"timeout", "error", "notmodified" 和 "parsererror"。Ajax 事件。

function (XMLHttpRequest, textStatus, errorThrown) {
    // 通常 textStatus 和 errorThrown 之中
    // 只有一個(gè)會(huì )包含信息
    this; // 調用本次AJAX請求時(shí)傳遞的options參數
}

globalBoolean

(默認: true) 是否觸發(fā)全局 AJAX 事件。設置為 false 將不會(huì )觸發(fā)全局 AJAX 事件,如 ajaxStart 或 ajaxStop 可用于控制不同的 Ajax 事件。

headersmapV1.5

Default: {}

一個(gè)額外的"{鍵:值}"對映射到請求一起發(fā)送。此設置被設置之前beforeSend函數被調用;因此,消息頭中的值設置可以在覆蓋beforeSend函數范圍內的任何設置。

ifModifiedBoolean

(默認: false) 僅在服務(wù)器數據改變時(shí)獲取新數據。使用 HTTP 包 Last-Modified 頭信息判斷。在jQuery 1.4中,他也會(huì )檢查服務(wù)器指定的'etag'來(lái)確定數據沒(méi)有被修改過(guò)。

isLocalmapV1.5.1

默認: 取決于當前的位置協(xié)議

允許當前環(huán)境被認定為“本地”,(如文件系統),即使jQuery默認情況下不會(huì )承認它。以下協(xié)議目前公認為本地:file, *-extension, and widget。如果isLocal設置需要修改,建議在$.ajaxSetup()方法中這樣做一次。

jsonpString

在一個(gè)jsonp請求中重寫(xiě)回調函數的名字。這個(gè)值用來(lái)替代在"callback=?"這種GET或POST請求中URL參數里的"callback"部分,比如{jsonp:'onJsonPLoad'}會(huì )導致將"onJsonPLoad=?"傳給服務(wù)器。

jsonpCallbackString

為jsonp請求指定一個(gè)回調函數名。這個(gè)值將用來(lái)取代jQuery自動(dòng)生成的隨機函數名。這主要用來(lái)讓jQuery生成度獨特的函數名,這樣管理請求更容易,也能方便地提供回調函數和錯誤處理。你也可以在想讓瀏覽器緩存GET請求的時(shí)候,指定這個(gè)回調函數名。

mimeTypeStringV1.5.1

一個(gè)mime類(lèi)型用來(lái)覆蓋XHR的 MIME類(lèi)型。

passwordString

用于響應HTTP訪(fǎng)問(wèn)認證請求的密碼

processDataBoolean

(默認: true) 默認情況下,通過(guò)data選項傳遞進(jìn)來(lái)的數據,如果是一個(gè)對象(技術(shù)上講只要不是字符串),都會(huì )處理轉化成一個(gè)查詢(xún)字符串,以配合默認內容類(lèi)型 "application/x-www-form-urlencoded"。如果要發(fā)送 DOM 樹(shù)信息或其它不希望轉換的信息,請設置為 false。

scriptCharsetString

只有當請求時(shí)dataType為"jsonp"或"script",并且type是"GET"才會(huì )用于強制修改charset。通常只在本地和遠程的內容編碼不同時(shí)使用。

statusCodemapV1.5

默認: {}

一組數值的HTTP代碼和函數對象,當響應時(shí)調用了相應的代碼。例如,如果響應狀態(tài)是404,將觸發(fā)以下警報:

$.ajax({
  statusCode: {404: function() {
    alert('page not found');
  }
});

success(data, textStatus, jqXHR)Function,Array

請求成功后的回調函數。參數:由服務(wù)器返回,并根據dataType參數進(jìn)行處理后的數據;描述狀態(tài)的字符串。還有 jqXHR(在jQuery 1.4.x的中,XMLHttpRequest) 對象 。在jQuery 1.5, 成功設置可以接受一個(gè)函數數組。每個(gè)函數將被依次調用。 Ajax 事件。

function (data, textStatus) {
    // data 可能是 xmlDoc, jsonObj, html, text, 等等...
    this; // 調用本次AJAX請求時(shí)傳遞的options參數
}

traditionalBoolean

如果你想要用傳統的方式來(lái)序列化數據,那么就設置為true。請參考工具分類(lèi)下面的jQuery.param 方法。

timeoutNumber

設置請求超時(shí)時(shí)間(毫秒)。此設置將覆蓋全局設置。

typeString

(默認: "GET") 請求方式 ("POST" 或 "GET"), 默認為 "GET"。注意:其它 HTTP 請求方法,如 PUT 和 DELETE 也可以使用,但僅部分瀏覽器支持。

urlString

(默認: 當前頁(yè)地址) 發(fā)送請求的地址。

usernameString

用于響應HTTP訪(fǎng)問(wèn)認證請求的用戶(hù)名

xhrFunction

需要返回一個(gè)XMLHttpRequest 對象。默認在IE下是ActiveXObject 而其他情況下是XMLHttpRequest 。用于重寫(xiě)或者提供一個(gè)增強的XMLHttpRequest 對象。這個(gè)參數在jQuery 1.3以前不可用。

xhrFieldsmapV1.5

一對“文件名-文件值”在本機設置XHR對象。例如,如果需要的話(huà),你可以用它來(lái)設置withCredentials為true的跨域請求。

示例

描述:

加載并執行一個(gè) JS 文件。

jQuery 代碼:
$.ajax({
  type: "GET",
  url: "test.js",
  dataType: "script"
});

描述:

保存數據到服務(wù)器,成功時(shí)顯示信息。

jQuery 代碼:
$.ajax({
   type: "POST",
   url: "some.php",
   data: "name=John&location=Boston",
   success: function(msg){
     alert( "Data Saved: " + msg );
   }
});

描述:

裝入一個(gè) HTML 網(wǎng)頁(yè)最新版本。

jQuery 代碼:
$.ajax({
  url: "test.html",
  cache: false,
  success: function(html){
    $("#results").append(html);
  }
});

描述:

同步加載數據。發(fā)送請求時(shí)鎖住瀏覽器。需要鎖定用戶(hù)交互操作時(shí)使用同步方式。

jQuery 代碼:
 var html = $.ajax({
  url: "some.php",
  async: false
 }).responseText;

描述:

發(fā)送 XML 數據至服務(wù)器。設置 processData 選項為 false,防止自動(dòng)轉換數據格式。

jQuery 代碼:
 var xmlDocument = [create xml document];
 $.ajax({
   url: "page.php",
   processData: false,
   data: xmlDocument,
   success: handleResponse
 });
男女疯狂一边摸一边做羞羞视频|啊好深好硬快点用力别停动态图|亚洲一区无码中文字幕|特级无码毛片免费视频播放▽|久久狠狠躁免费观看|国内精品久久久久久网站