帶你了解jQuery.ajaxSetup()的用法實例

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

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

該函數屬於全域jQuery物件。

語法

jQuery 1.1 新增此靜態函數。

jQuery.ajaxSetup( settings )

參數

##settings

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

關於

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

在下面的表格中列出了可能的名稱/值：

 

#名稱值/描述async布林值，表示請求是否非同步處理。預設是 true。 beforeSend(#發送請求前執行的函數。 cache布林值，表示瀏覽器是否快取被要求頁面。預設是 true。 complete(要求完成時運行的函數（在請求成功或失敗之後均調用，即在success 和error 函數之後）。 contentType傳送資料到伺服器時所使用的內容類型。預設是："application/x-www-form-urlencoded"。 context為所有 AJAX 相關的data規定要傳送到伺服器的資料。 dataFilter(用於處理 XMLHttpRequest 原始回應資料的函數。 dataType預期的伺服器回應的error(如果請求失敗要執行的函數。 global布林值，規定是否為請求觸發全域 AJAX ifModified布林值，規定是否僅在最後一次要求以來回應發生變更時才請求成功。預設是 false。 jsonp在一個 jsonp 中重寫回呼函數的jsonpCallback在一個 jsonp 中規定回呼函數的名稱。 password規定在 HTTP 存取認證請求中使用的密碼。 processData布林值，規定透過請求傳送的資料是否轉換為查詢字串。預設是 true。 scriptCharset規定請求的success(當請求成功時執行的函數。 timeout設定本機的請求逾時時間（以毫秒計）。 traditional布林值，規定是否使用參數序列化的傳統樣式。 type規定請求的類型（GET 或 POST）。 url規定發送請求的 URL。預設是當前頁面。 username規定在 HTTP 存取認證請求中使用的使用者名稱。 xhr用於建立 XMLHttpRequest 物件的函數。

xhr)
xhr,status)
	回呼函數規定 "this" 值。
data,type)
	資料類型。
xhr,status,error)
	事件處理程式。預設是 true。
	字串。
	字元集。
result,status,xhr)

傳回值

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

範例&說明

 

<span class="com">//设置AJAX的全局默认选项<span class="pln"><br/>$<span class="pun">.<span class="pln">ajaxSetup<span class="pun">(<span class="pln"> <span class="pun">{<span class="pln"><br/>    url<span class="pun">:<span class="pln"> <span class="str">"/index.html"<span class="pln"> <span class="pun">,<span class="pln"> <span class="com">// 默认URL<span class="pln"><br/>    aysnc<span class="pun">:<span class="pln"> <span class="kwd">false<span class="pln"> <span class="pun">,<span class="pln"> <span class="com">// 默认同步加载<span class="pln"><br/>    type<span class="pun">:<span class="pln"> <span class="str">"POST"<span class="pln"> <span class="pun">,<span class="pln"> <span class="com">// 默认使用POST方式<span class="pln"><br/>    headers<span class="pun">:<span class="pln"> <span class="pun">{<span class="pln"> <span class="com">// 默认添加请求头<span class="pln"><br/>        <span class="str">"Author"<span class="pun">:<span class="pln"> <span class="str">"CodePlayer"<span class="pln"> <span class="pun">,<span class="pln"><br/>        <span class="str">"Powered-By"<span class="pun">:<span class="pln"> <span class="str">"CodePlayer"<span class="pln"><br/>    <span class="pun">}<span class="pln"> <span class="pun">,<span class="pln"><br/>    error<span class="pun">:<span class="pln"> <span class="kwd">function<span class="pun">(<span class="pln">jqXHR<span class="pun">,<span class="pln"> textStatus<span class="pun">,<span class="pln"> errorMsg<span class="pun">){<span class="pln"> <span class="com">// 出错时默认的处理函数<span class="pln"><br/>        <span class="com">// jqXHR 是经过jQuery封装的XMLHttpRequest对象<span class="pln"><br/>        <span class="com">// textStatus 可能为： null、"timeout"、"error"、"abort"或"parsererror"<span class="pln"><br/>        <span class="com">// errorMsg 可能为： "Not Found"、"Internal Server Error"等<span class="pln"><br/><br/>        <span class="com">// 提示形如：发送AJAX请求到"/index.html"时出错[404]：Not Found<span class="pln"><br/>        alert<span class="pun">(<span class="pln"> <span class="str">&#39;发送AJAX请求到"&#39;<span class="pln"> <span class="pun">+<span class="pln"> <span class="kwd">this<span class="pun">.<span class="pln">url <span class="pun">+<span class="pln"> <span class="str">&#39;"时出错[&#39;<span class="pln"> <span class="pun">+<span class="pln"> jqXHR<span class="pun">.<span class="pln">status <span class="pun">+<span class="pln"> <span class="str">&#39;]：&#39;<span class="pln"> <span class="pun">+<span class="pln"> errorMsg <span class="pun">);<span class="pln">        <br/>    <span class="pun">}<span class="pln"><br/><span class="pun">}<span class="pln"> <span class="pun">);</span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span>

<span class="pln">$<span class="pun">.<span class="pln">ajax<span class="pun">(<span class="pln"> <span class="pun">{<span class="pln"><br/>    url<span class="pun">:<span class="pln"> <span class="str">"myurl.php?action=list"<span class="pln"> <span class="pun">,<span class="pln"><br/>    type<span class="pun">:<span class="pln"> <span class="str">"GET"<span class="pln"> <span class="pun">,<span class="pln"><br/>    success<span class="pun">:<span class="pln"> <span class="kwd">function<span class="pun">(<span class="pln"> data<span class="pun">,<span class="pln"> textStatus<span class="pun">,<span class="pln"> jqXHR <span class="pun">){<span class="pln"><br/>        alert<span class="pun">(<span class="str">"返回数据："<span class="pln"> <span class="pun">+<span class="pln"> data<span class="pun">);<span class="pln"><br/>    <span class="pun">}<span class="pln"> <span class="pun">,<span class="pln"><br/>    error<span class="pun">:<span class="pln"> <span class="kwd">function<span class="pun">(<span class="pln">jqXHR<span class="pun">,<span class="pln"> textStatus<span class="pun">,<span class="pln"> errorMsg<span class="pun">){<span class="pln"><br/>        alert<span class="pun">(<span class="str">"自己的error!"<span class="pun">);<span class="pln">        <br/>    <span class="pun">}<span class="pln"><br/><span class="pun">});</span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span>

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