ajax函數(shù)有什么參數(shù)

這篇文章將為大家詳細(xì)講解有關(guān)ajax函數(shù)有什么參數(shù)，小編覺得挺實(shí)用的，因此分享給大家做個(gè)參考，希望大家閱讀完這篇文章后可以有所收獲。

ajax函數(shù)的參數(shù)有：options、async、cache、contentType、context、data、dataFilter、dataType、error、global、ifModified、jsonp、processData等。

本教程操作環(huán)境：windows7系統(tǒng)、jquery1.10.2版本、Dell G3電腦。

ajax() 函數(shù)通過(guò) HTTP 請(qǐng)求加載遠(yuǎn)程數(shù)據(jù)。

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

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

注意：所有的選項(xiàng)都可以通過(guò) $.ajaxSetup() 函數(shù)來(lái)全局設(shè)置。

語(yǔ)法：

jQuery.ajax([settings])

參數(shù)：

options

• 類型：Object

• 可選。AJAX 請(qǐng)求設(shè)置。所有選項(xiàng)都是可選的。

async

• 類型：Boolean

• 默認(rèn)值: true。默認(rèn)設(shè)置下，所有請(qǐng)求均為異步請(qǐng)求。如果需要發(fā)送同步請(qǐng)求，請(qǐng)將此選項(xiàng)設(shè)置為 false。

• 注意，同步請(qǐng)求將鎖住瀏覽器，用戶其它操作必須等待請(qǐng)求完成才可以執(zhí)行。

beforeSend(XHR)

• 類型：Function

• 發(fā)送請(qǐng)求前可修改 XMLHttpRequest 對(duì)象的函數(shù)，如添加自定義 HTTP 頭。

• XMLHttpRequest 對(duì)象是唯一的參數(shù)。

• 這是一個(gè) Ajax 事件。如果返回 false 可以取消本次 ajax 請(qǐng)求。

cache

• 類型：Boolean

• 默認(rèn)值: true，dataType 為 script 和 jsonp 時(shí)默認(rèn)為 false。設(shè)置為 false 將不緩存此頁(yè)面。

• jQuery 1.2 新功能。

complete(XHR, TS)

• 類型：Function

• 請(qǐng)求完成后回調(diào)函數(shù) (請(qǐng)求成功或失敗之后均調(diào)用)。

• 參數(shù)： XMLHttpRequest 對(duì)象和一個(gè)描述請(qǐng)求類型的字符串。

• 這是一個(gè) Ajax 事件。

contentType

• 類型：String

• 默認(rèn)值: "application/x-www-form-urlencoded"。發(fā)送信息至服務(wù)器時(shí)內(nèi)容編碼類型。

• 默認(rèn)值適合大多數(shù)情況。如果你明確地傳遞了一個(gè) content-type 給 $.ajax() 那么它必定會(huì)發(fā)送給服務(wù)器（即使沒(méi)有數(shù)據(jù)要發(fā)送）。

context

• 類型：Object

• 這個(gè)對(duì)象用于設(shè)置 Ajax 相關(guān)回調(diào)函數(shù)的上下文。也就是說(shuō)，讓回調(diào)函數(shù)內(nèi) this 指向這個(gè)對(duì)象（如果不設(shè)定這個(gè)參數(shù)，那么 this 就指向調(diào)用本次 AJAX 請(qǐng)求時(shí)傳遞的 options 參數(shù)）。比如指定一個(gè) DOM 元素作為 context 參數(shù)，這樣就設(shè)置了 success 回調(diào)函數(shù)的上下文為這個(gè) DOM 元素。

• 就像這樣：

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

data

• 類型：String

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

dataFilter

• 類型：Function

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

dataType

• 類型：String

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

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

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

• "script": 返回純文本 JavaScript 代碼。不會(huì)自動(dòng)緩存結(jié)果。除非設(shè)置了 "cache" 參數(shù)。注意：在遠(yuǎn)程請(qǐng)求時(shí)(不在同一個(gè)域下)，所有 POST 請(qǐng)求都將轉(zhuǎn)為 GET 請(qǐng)求。（因?yàn)閷⑹褂?DOM 的 script標(biāo)簽來(lái)加載）

• "json": 返回 JSON 數(shù)據(jù) 。

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

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

error

• 類型：Function

• 默認(rèn)值: 自動(dòng)判斷 (xml 或 html)。請(qǐng)求失敗時(shí)調(diào)用此函數(shù)。

• 有以下三個(gè)參數(shù)：XMLHttpRequest 對(duì)象、錯(cuò)誤信息、（可選）捕獲的異常對(duì)象。

• 如果發(fā)生了錯(cuò)誤，錯(cuò)誤信息（第二個(gè)參數(shù)）除了得到 null 之外，還可能是 "timeout", "error", "notmodified" 和 "parsererror"。

• 這是一個(gè) Ajax 事件。

global

• 類型：Boolean

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

ifModified

• 類型：Boolean

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

jsonp

• 類型：String

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

jsonpCallback

• 類型：String

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

password

• 類型：String

• 用于響應(yīng) HTTP 訪問(wèn)認(rèn)證請(qǐng)求的密碼

processData

• 類型：Boolean

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

scriptCharset

• 類型：String

• 只有當(dāng)請(qǐng)求時(shí) dataType 為 "jsonp" 或 "script"，并且 type 是 "GET" 才會(huì)用于強(qiáng)制修改 charset。通常只在本地和遠(yuǎn)程的內(nèi)容編碼不同時(shí)使用。

success

• 類型：Function

• 請(qǐng)求成功后的回調(diào)函數(shù)。

• 參數(shù)：由服務(wù)器返回，并根據(jù) dataType 參數(shù)進(jìn)行處理后的數(shù)據(jù)；描述狀態(tài)的字符串。

• 這是一個(gè) Ajax 事件。

traditional

• 類型：Boolean

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

timeout

• 類型：Number

• 設(shè)置請(qǐng)求超時(shí)時(shí)間（毫秒）。此設(shè)置將覆蓋全局設(shè)置。

type

• 類型：String

• 默認(rèn)值: "GET")。請(qǐng)求方式 ("POST" 或 "GET")， 默認(rèn)為 "GET"。注意：其它 HTTP 請(qǐng)求方法，如 PUT 和 DELETE 也可以使用，但僅部分瀏覽器支持。

url

• 類型：String

• 默認(rèn)值: 當(dāng)前頁(yè)地址。發(fā)送請(qǐng)求的地址。

username

• 類型：String

• 用于響應(yīng) HTTP 訪問(wèn)認(rèn)證請(qǐng)求的用戶名。

xhr

• 類型：Function

• 需要返回一個(gè) XMLHttpRequest 對(duì)象。默認(rèn)在 IE 下是 ActiveXObject 而其他情況下是 XMLHttpRequest 。用于重寫或者提供一個(gè)增強(qiáng)的 XMLHttpRequest 對(duì)象。這個(gè)參數(shù)在 jQuery 1.3 以前不可用。

案例代碼：

$(function(){
    $('#send').click(function(){
         $.ajax({
             type: "GET",
             url: "test.json",
             data: {username:$("#username").val(), content:$("#content").val()},
             dataType: "json",
             success: function(data){
                         $('#resText').empty();   //清空resText里面的所有內(nèi)容
                         var html = ''; 
                         $.each(data, function(commentIndex, comment){
                               html += '<div class="comment"><h7>' + comment['username']
                                         + ':</h7><p class="para"' + comment['content']
                                         + '</p></div>';
                         });
                         $('#resText').html(html);
                      }
         });
    });
});

關(guān)于“ajax函數(shù)有什么參數(shù)”這篇文章就分享到這里了，希望以上內(nèi)容可以對(duì)大家有一定的幫助，使各位可以學(xué)到更多知識(shí)，如果覺得文章不錯(cuò)，請(qǐng)把它分享出去讓更多的人看到。