jQuery ajax - ajax() 方法

实例

通过 AJAX 加载一段文本：

jQuery ìwọn àwọn àpamọ́:}

$(document).ready(function(){
  $("#b01").click(function(){
  htmlobj=$.ajax({url:"/jquery/test1.txt",async:false});
  $("#myDiv").html(htmlobj.responseText);
  });
});

Àwọn ìwọn HTML:

<div id="myDiv"><h2>Yíyàtọ̀ Ìwọn Ọ̀rọ̀ láti AJAX</h2></div>
<button id="b01" type="button">Yíyàtọ̀ Ìwọn Ọ̀rọ̀</button>

Tí o bá fẹ́ gbìyànjú.

Àtúnṣe àti ìlò

ajax() ìṣàgbékalẹ̀ lè lo ìpàdé HTTP láti lo àwọn àwọn àpamọ́ tó wà láàárín.

Èyí jẹ́ ìṣàgbékalẹ̀ AJAX nípa jQuery. Ìṣàgbékalẹ̀ tí ó rọrùn láti lò ní àwọn ìṣàgbékalẹ̀ ìpàdé tí ó kàn nípa $.get, $.post àti wọn. $.ajax() yóò dá àwọn àpamọ́ XMLHttpRequest tí ó ṣe àtúnṣe sí. Ọ̀pọ̀ ìgbà o kò ní láti ṣe àtúnṣe sí àwọn àpamọ́ yìí, pàápàá jùlọ tí o bá fẹ́ ṣe àtúnṣe sí àwọn àpamọ́ tí kò jẹ́ àwọn tí ó máa ń lò, láti rí ìlọ́wọ́ tí ó pọ̀ sí i.

Ní àwọn àpẹẹrẹ, $.ajax() lè jẹ́ láìní àwọn àpamọ́ tí ó kàn.

注意：Gbogbo àwọn àtúnṣe yóò jẹ́ àtúnṣe nípasẹ̀ orí $.ajaxSetup() ìṣàgbékalẹ̀.

Atọ́ka

jQuery.ajax([settings])

Àwọn àpamọ́.	Àpèjúwe
settings	Àpẹẹrẹ. Àtúnṣe àwọn àpamọ́ fún ìpàdé Ajax. gbogbo àwọn àpamọ́ yóò jẹ́ àpẹẹrẹ. O lè ṣe àtúnṣe àkókòwọléwọlé nípa gbogbo àwọn àpamọ́ nípasẹ̀ orí $.ajaxSetup().

Àwọn àpamọ́.

Àpèjúwe

settings

Àpẹẹrẹ. Àtúnṣe àwọn àpamọ́ fún ìpàdé Ajax. gbogbo àwọn àpamọ́ yóò jẹ́ àpẹẹrẹ.

O lè ṣe àtúnṣe àkókòwọléwọlé nípa gbogbo àwọn àpamọ́ nípasẹ̀ orí $.ajaxSetup().

Àwọn àpamọ́.

options

类型：Object

Àpẹẹrẹ. Àtúnṣe AJAX ìpàdé. gbogbo àwọn àtúnṣe yóò jẹ́ àpẹẹrẹ.

async

Tiru: Boolean

Àkókòwọlé: true. Nípa àtúnṣe tí ó jẹ́ àtìlẹyìn, gbogbo ìpàdé yóò jẹ́ ìpàdé tí ó máà tìlẹ̀kùn. Tí o bá fẹ́ fi ìpàdé tí ó jẹ́ àtìlẹyìn àtúnṣe, o ní láti sọ ìyẹn sí false.

Rí àwọn, ìpàdé tí ó jẹ́ àtìlẹyìn yóò tìlẹ̀kùn àwọn ìṣẹ̀lẹ̀ ìṣàmúlò, àwọn ìṣẹ̀lẹ̀ mìíràn nípa àwọn òǹṣe yóò máà ṣe àṣeyọrí títí tí ìpàdé náà bá parí.

beforeSend(XHR)

Tiru: Function

Àwọn àkókòwọlé lórí ìparí rẹ̀ lè ṣe àtúnṣe sí XMLHttpRequest àwọn àpamọ́, bíi àfikún àwọn ìtàkùn HTTP tó wọn yóò.

XMLHttpRequest àwọn àpamọ́ ni àpamọ́ kan náà.

Èyí jẹ́ ìṣẹ̀lẹ̀ Ajax. Tí o bá dá ìdáwọlé false, o lè jáwọ́ ìpàdé Ajax yìí.

cache

Tiru: Boolean

Àkókòwọlé: true, dataType jẹ́ script àti jsonp nípa ìtọ́jú false. Tí o bá sọ sí false, o kò ní fi ìpàdé yìí pààrọ̀.

jQuery 1.2 ɪyàwọn àwọn àṣà.

complete(XHR, TS)

Tiru: Function

请求完成后回调函数 (请求成功或失败之后均调用)。

参数： XMLHttpRequest 对象和一个描述请求类型的字符串。

An gudanin shi ne event Ajax.

contentType

Tiru: String

默认值: "application/x-www-form-urlencoded"。发送信息至服务器时内容编码类型。

默认值适合大多数情况。如果你明确地传递了一个 content-type 给 $.ajax() 那么它必定会发送给服务器（即使没有数据要发送）。

context

类型：Object

这个对象用于设置 Ajax 相关回调函数的上下文。也就是说，让回调函数内 this 指向这个对象（如果不设定这个参数，那么 this 就指向调用本次 AJAX 请求时传递的 options 参数）。比如指定一个 DOM 元素作为 context 参数，这样就设置了 success 回调函数的上下文为这个 DOM 元素。

Yayi yawon da wannan:

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

data

Tiru: String

Saman da za'a tsara ga saman da ake samarwa. Za'a sami saman a cikin tsarin saman da ake samarwa. An haɗa da URL a cikin saman GET. Gana daga ƙaramin ƙa'idar processData domin ki gano ƙa'idar yin saman a cikin tsarin saman. Musta yin saman a cikin ƙarfin Key/Value. Idan shine tsohon abin da ake samarwa, jQuery za'a sami saman a cikin ƙarfin sama da sama. Misali {foo:["bar1", "bar2"]} za'a sami saman a cikin '&foo=bar1&foo=bar2'.

dataFilter

Tiru: Function

Fonki wanda zai iya sami saman da ake samarwa a cikin Ajax. Yana samarwa da data da type daga abin da ake samarwa: data shine saman da ake samarwa a cikin Ajax, kuma type shine sabon saman da ake samarwa a cikin jQuery.ajax. Dabi'insa za'a sami saman da zai iya sami saman a cikin jQuery.

dataType

Tiru: String

Tasiyarin da ake tashiyar saman kuma ga baiwa saman. Idan an ba ta gani, jQuery za'a sami saman da zai iya sami saman da zai iya sami saman da ya kamata sami saman da za'a iya sami saman. A 1.4, JSON za'a sami sabon abin JavaScript, kuma script za'a koyar da wannan sabon script. Sannan saman da za'a sami daga babban saman za'a yi lafazin sa kuma zai iya kai wa jumlar. Dabi'insa:

"xml": Returns an XML document, which can be processed by jQuery.
"html": Returns plain text HTML information; the script tags included will be executed when inserted into the dom.
"script": Returns plain text JavaScript code. It will not automatically cache the results unless the "cache" parameter is set. Note: When making remote requests (not in the same domain), all POST requests will be converted to GET requests. (because it will use the DOM script tag to load)
"json": Returns JSON data.
"jsonp": JSONP format. When calling a function in JSONP format, such as "myurl?callback=?", jQuery will automatically replace ? with the correct function name to execute the callback function.
"text": Returns a plain text string

error

Tiru: Function

Default value: automatically judge (xml or html). Call this function when the request fails.

There are three parameters: XMLHttpRequest object, error information, (optional) caught exception object.

If an error occurs, the error information (the second parameter) in addition to getting null, it may also be "timeout", "error", "notmodified" and "parsererror".

An gudanin shi ne event Ajax.

global

Tiru: Boolean

Whether to trigger global AJAX events. Default value: true. Set to false to not trigger global AJAX events, such as ajaxStart or ajaxStop can be used to control different Ajax events.

ifModified

Tiru: Boolean

Only get new data when the server data changes. Default value: false. Use HTTP packet Last-Modified header information to judge. In jQuery 1.4, it will also check the 'etag' specified by the server to determine that the data has not been modified.

jsonp

Tiru: String

A can rewrite the name of the callback function in a jsonp request. This value is used to replace the "callback" part in the URL parameters of GET or POST requests such as "callback=?", such as {jsonp:'onJsonPLoad'} will cause "onJsonPLoad=?" to be transmitted to the server.

jsonpCallback

Tiru: String

An gudanin maganar da ke cikin kwanan neman jsonp don amfani da tarin neman. Manzarta na wanda zai kai amfani da kwayar yanayi na gudanin da kai kaiyawa. An gudanin amfani da kwayar yanayi na gudanin don kai kaiyawa kwayar yanayi da kwayar kura, kuma kai kaiyawa kwayar yanayi. An zama kamar yadda a kai kaiyawa kwayar yanayi da kai kaiyawa kwayar kura. An zama kamar yadda a kai kaiyawa kwayar yanayi don kai kaiyawa kwayar yanayi a kai kaiyawa GET.

password

Tiru: String

An gudanin maganar da ke cikin kwanan neman HTTP don sauraro.

processData

Tiru: Boolean

Manzarta: true. Idan a bai so amfani da, data na kai neman wanda yana cikin data ko wanda yana cikin kwayar yanayi (kamar yadda a kai tsaro), a kai amfani ko amfani da kwayar yanayi "application/x-www-form-urlencoded". Idan a bai so amfani da DOM tree ko sauraro na dake yana cikin amfani, a so shi ne false.

scriptCharset

Tiru: String

Kawai idan dataType na gudanin shi "jsonp" ko "script", kuma type shi "GET", a yi amfani don kai gudanin charset. Idan a bai so amfani da, kawai a kaiyawa na kaiyawa a gaba da daidai ko kwayar yanayi.

success

Tiru: Function

Kwallon daidai ko shi a kai neman.

Parameters: daidai ko data na gudanin a kai kaiyawa daidai ko dataType na gudanin, daidai ko kwanan neman na kai kaiyawa.

An gudanin shi ne event Ajax.

traditional

Tiru: Boolean

Idan a bai so kai amfani da tarin neman daidai ko tsari na jinkirin, a so shi ne true. Ci gaba: kiyaste ko amfani da tarin neman jQuery.param a kiyaste.

timeout

Tiru: Number

An gudanin wakokin neman (millisecond). Manzarta na wanda ya kai tsaro ga kai tsaro daidai ko wanda ya kai tsaro a gaba.

type

Tiru: String

Manzarta: "GET"). Tarin neman ("POST" ko "GET") wanda yana zama "GET". Ci gaba: dukka tsausi HTTP neman kamar PUT da DELETE za a iya amfani, amma kawai dukkanin kewayar yanayi kei kai tsaro.

url

Tiru: String

Manzarta: fara cikin shi, tsohon farin gida. Tsohon farin da an kai neman.

username

Tiru: String

An gudanin maganar da ke cikin kwanan neman HTTP don sauraro.

xhr

Tiru: Function

A ya'a dake gudanin ga XMLHttpRequest na. Tsawon IE na wanda yana shi ActiveXObject a tsawon yadda dake yana shi XMLHttpRequest. An gudanin ko daidai ko yana zama XMLHTTPRequest na tsari ko yana zama kaiyawa. Manzarta na wanda ya kai tsaro a jQuery 1.3 kafin a zai zama kama yadda.

回调函数

如果要处理 $.ajax() 得到的数据，则需要使用回调函数：beforeSend、error、dataFilter、success、complete。

beforeSend

在发送请求之前调用，并且传入一个 XMLHttpRequest 作为参数。

error

在请求出错时调用。传入 XMLHttpRequest 对象，描述错误类型的字符串以及一个异常对象（如果有的话）

dataFilter

在请求成功之后调用。传入返回的数据以及 "dataType" 参数的值。并且必须返回新的数据（可能是处理过的）传递给 success 回调函数。

success

当请求之后调用。传入返回后的数据，以及包含成功代码的字符串。

complete

当请求完成之后调用这个函数，无论成功或失败。传入 XMLHttpRequest 对象，以及一个包含成功或错误代码的字符串。

数据类型

$.ajax() 函数依赖服务器提供的信息来处理返回的数据。如果服务器报告说返回的数据是 XML，那么返回的结果就可以用普通的 XML 方法或者 jQuery 的选择器来遍历。如果见得到其他类型，比如 HTML，则数据就以文本形式来对待。

通过 dataType 选项还可以指定其他不同数据处理方式。除了单纯的 XML，还可以指定 html、json、jsonp、script 或者 text。

其中，text 和 xml 类型返回的数据不会经过处理。数据仅仅简单的将 XMLHttpRequest 的 responseText 或 responseHTML 属性传递给 success 回调函数。

注意：我们必须确保网页服务器报告的 MIME 类型与我们选择的 dataType 所匹配。比如说，XML的话，服务器端就必须声明 text/xml 或者 application/xml 来获得一致的结果。

idake za html tura, kowararun JavaScript a hanyan za a baiya HTML gane kaiya, za a tura. Kowa da, za a tura script tura, za a tura hanyan JavaScript a gane kaiya za a baiya a baiya gane kaiya.

如果指定为 json 类型，则会把获取到的数据作为一个 JavaScript 对象来解析，并且把构建好的对象作为结果返回。为了实现这个目的，它首先尝试使用 JSON.parse()。如果浏览器不支持，则使用一个函数来构建。

JSON 数据是一种能很方便通过 JavaScript 解析的结构化数据。如果获取的数据文件存放在远程服务器上（域名不同，也就是跨域获取数据），则需要使用 jsonp 类型。使用这种类型的话，会创建一个查询字符串参数 callback=? ，这个参数会加在请求的 URL 后面。服务器端应当在 JSON 数据前加上回调函数名，以便完成一个有效的 JSONP 请求。如果要指定回调函数的参数名来取代默认的 callback，可以通过设置 $.ajax() 的 jsonp 参数。

注意：JSONP 是 JSON 格式的扩展。它要求一些服务器端的代码来检测并处理查询字符串参数。

如果指定了 script 或者 jsonp 类型，那么当从服务器接收到数据时，实际上是用了

课程表

Rarrabawar jQuery

jQuery 效果

jQuery HTML

Yanar jQuery

jQuery AJAX

jQuery 杂项

Shirin jQuery

Manufar jQuery

选修课

课程推荐：

jQuery ajax - ajax() 方法

实例

Àtúnṣe àti ìlò

Atọ́ka

Àwọn àpamọ́.

回调函数

beforeSend

error

dataFilter

success

complete

数据类型