ajax函数怎么使用
本篇内容主要讲解"ajax函数怎么使用",感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷,实用性强。下面就让小编来带大家学习"ajax函数怎么使用"吧!
ajax函数是指jQuery.ajax()函数,该函数用于通过后台HTTP请求加载远程数据,是jQuery封装的AJAX技术实现,通过该函数,我们无需刷新当前页面即可获取远程服务器上的数据。
本文操作环境:Windows7系统,jquery3.2.1版,Dell G3电脑。
ajax函数是什么?
jQuery.ajax() 函数详解
jQuery.ajax()
函数用于通过后台HTTP请求加载远程数据。
jQuery.ajax()
函数是jQuery封装的AJAX技术实现,通过该函数,我们无需刷新当前页面即可获取远程服务器上的数据。
jQuery.ajax()
函数是jQuery的底层AJAX实现。jQuery.get()、 jQuery.post()、load()、 jQuery.getJSON()、 jQuery.getScript()等函数都是该函数的简化形式(都调用该函数,只是参数设置有所不同或有所省略)。
该函数属于全局jQuery
对象(也可理解为静态函数)。
参数
请根据前面语法部分所定义的参数名称查找对应的参数。
参数 | 描述 |
---|---|
url | String类型URL请求字符串。 |
settings | 可选/Object类型一个Object对象,其中的每个属性用来指定发送请求所需的额外参数设置。 |
参数settings
是一个对象,jQuery.ajax()
可以识别该对象的以下属性(它们都是可选的):
accepts --- Object类型
默认值:取决于dataType
属性。
发送的内容类型请求头,用于告诉服务器--浏览器可以接收服务器返回何种类型的响应。
async --- Boolean类型
默认值:true
。
指示是否是异步请求。同步请求将锁定浏览器,直到获取到远程数据后才能执行其他操作。
beforeSend---Function类型
指定在请求发送前需要执行的回调函数。该函数还有两个参数:其一是jqXHR
对象,其二是当前settings
对象。这是一个Ajax事件,如果该函数返回false
,将取消本次ajax请求。
cache---Boolean类型
默认值:true
(dataType
为'script'或'jsonp'时,则默认为false
)。
指示是否缓存URL请求。如果设为false
将强制浏览器不缓存当前URL请求。该参数只对HEAD、GET请求有效(POST请求本身就不会缓存)。
complete---Function/Array类型
指定请求完成(无论成功或失败)后需要执行的回调函数。该函数还有两个参数:一个是jqXHR
对象,一个是表示请求状态的字符串('success'、 'notmodified'、 'error'、 'timeout'、 'abort'或'parsererror')。这是一个Ajax事件。
从jQuery 1.5开始,该属性值可以是数组形式的多个函数,每个函数都将被回调执行。
contents---Object类型1.5 新增
一个以"{字符串:正则表达式}"配对的对象,用来确定jQuery将如何解析响应,给定其内容类型。
contentType---String类型
默认值:'application/x-www-form-urlencoded; charset=UTF-8'。
使用指定的内容编码类型将数据发送给服务器。W3C的XMLHttpRequest规范规定charset始终是UTF-8,你如果将其改为其他字符集,也无法强制浏览器更改字符编码。
context---Object类型
用于设置Ajax相关回调函数的上下文对象(也就是函数内的this
指针)。
converters --- Object类型1.5 新增
默认值:{'* text': window.String, 'text html': true, 'text json': jQuery.parseJSON, 'text xml': jQuery.parseXML}
。
一个数据类型转换器。每个转换器的值都是一个函数,用于返回响应转化后的值。
crossDomain---Boolean类型1.5 新增
默认值:同域请求为false
,跨域请求为true
。
指示是否是跨域请求。如果你想在同一域中强制跨域请求(如JSONP形式),请设置为true。例如,这允许服务器端重定向到另一个域。
data---任意类型
发送到服务器的数据,它将被自动转为字符串类型。如果是GET请求,它将被附加到URL后面。
dataFilter---Function类型
指定处理响应的原始数据的回调函数。该函数还有两个参数:其一表示响应的原始数据的字符串,其二是dataType
属性字符串。
dataType---String类型
默认值:jQuery智能猜测,猜测范围(xml、 json、 script或html)
指定返回的数据类型。该属性值可以为:
'xml' :返回XML文档,可使用jQuery进行处理。
'html': 返回HTML字符串。
'script': 返回JavaScript代码。不会自动缓存结果。除非设置了
cache
参数。注意:在远程请求时(不在同一个域下),所有POST请求都将转为GET请求。(因为将使用DOM的script标签来加载)'json': 返回JSON数据。JSON数据将使用严格的语法进行解析(属性名必须加双引号,所有字符串也必须用双引号),如果解析失败将抛出一个错误。从jQuery 1.9开始,空内容的响应将返回
null
或{}
。'jsonp': JSONP格式。使用JSONP形式调用函数时,如"url?callback=?",jQuery将自动替换第二个?为正确的函数名,以执行回调函数。
'text': 返回纯文本字符串。
error---Function/Array类型
指定请求失败时执行的回调函数。该函数有3个参数:jqXHR对象、 请求状态字符串(null、 'timeout'、 'error'、 'abort'和'parsererror')、 错误信息字符串(响应状态的文本描述部分,例如'Not Found'或'Internal Server Error')。这是一个Ajax事件。跨域脚本和跨域JSONP请求不会调用该函数。
从jQuery 1.5开始,该属性值可以是数组形式的多个函数,每个函数都将被回调执行。
global---Boolean类型
默认值:true
。
指示是否触发全局Ajax事件。将该值设为false
将阻止全局事件处理函数被触发,例如ajaxStart()和ajaxStop()。它可以用来控制各种Ajax事件。
headers---Object类型1.5 新增
默认值:{}
。
以对象形式指定附加的请求头信息。请求头X-Requested-With: XMLHttpRequest
将始终被添加,当然你也可以在此处修改默认的XMLHttpRequest值。headers
中的值可以覆盖beforeSend
回调函数中设置的请求头(意即beforeSend先被调用)。
$.ajax({ url: "my.php" , headers: { "Referer": "http://www.365mini.com" // 有些浏览器不允许修改该请求头 ,"User-Agent": "newLine" // 有些浏览器不允许修改该请求头 ,"X-Power": "newLine" ,"Accept-Language": "en-US" }});
ifModified---Boolean类型
默认值:false
。
允许当前请求仅在服务器数据改变时获取新数据(如未更改,浏览器从缓存中获取数据)。它使用HTTP头信息Last-Modified
来判断。从jQuery 1.4开始,他也会检查服务器指定的'etag'来确定数据是否已被修改。
isLocal---Boolean类型1.5.1 新增
默认值:取决于当前的位置协议。
允许将当前环境视作"本地",(例如文件系统),即使默认情况下jQuery不会如此识别它。目前,以下协议将被视作本地:file
、*-extension
和widget
。
jsonp---String类型
重写JSONP请求的回调函数名称。该值用于替代"url?callback=?"中的"callback"部分。
jsonpCallback---String/Function类型
为JSONP请求指定一个回调函数名。这个值将用来取代jQuery自动生成的随机函数名。
从jQuery 1.5开始,你也可以指定一个函数来返回所需的函数名称。
mimeType---String类型1.5.1 新增
一个mime类型用来覆盖XHR的mime类型。
password---String类型
用于响应HTTP访问认证请求的密码。
processData---Boolean类型
默认值:true
。
默认情况下,通过data
属性传递进来的数据,如果是一个对象(技术上讲,只要不是字符串),都会处理转化成一个查询字符串,以配合默认内容类型 "application/x-www-form-urlencoded"。如果要发送 DOM树信息或其它不希望转换的信息,请设置为false
。
scriptCharset---String类型
设置该请求加载的脚本文件的字符集。只有当请求时dataType为"jsonp"或"script",并且type是"GET"才会用于强制修改charset。这相当于设置