ajaxComplete()
函数用于设置当AJAX请求完成(无论成功或失败)时执行的回调函数。
这是一个全局AJAX事件函数,用于为所有AJAX请求的ajaxComplete事件绑定事件处理函数。当AJAX请求完成(无论成功或失败)时,将触发ajaxComplete事件,并执行绑定的事件处理函数。
该函数必须在jQuery对象实例上调用,ajaxComplete()
将为每个匹配元素的ajaxComplete事件绑定处理函数。当AJAX请求完成后,所有匹配元素上的处理函数都将被触发执行。事件处理函数内的this
将指向当前DOM元素。
你可以在同一元素多次调用该函数,从而绑定多个事件处理函数。触发ajaxComplete事件时,jQuery会按照绑定的先后顺序依次执行绑定的事件处理函数。
从jQuery 1.8开始,该函数只能为document
对象的ajaxComplete事件绑定处理函数,为其他元素绑定的事件处理函数不会起作用。
如果在jQuery.ajax()或jQuery.ajaxSetup()中将选项参数global
设为false
,可以禁止该AJAX请求触发全局的AJAX事件。
该函数属于jQuery
对象(实例)。
语法
jQuery 1.0 新增该函数。
参数
参数 | 描述 |
---|---|
handler | Function类型触发该事件时,需要执行的事件处理函数。 |
回调函数handler
有3个参数:其一是表示当前事件的Event对象,其二是发送当前AJAX请求的jqXHR对象,其三是包含为本次AJAX请求设置的所有参数选项(包括无需指定的默认参数选项)的Object对象。
jqXHR
对象是经过jQuery封装的类似XMLHttpRequest的对象。
返回值
ajaxComplete()
函数的返回值为jQuery类型,返回当前jQuery对象本身。
示例&说明
请参考以下HTML示例代码:
以下是与ajaxComplete()
函数相关的jQuery示例代码,以演示ajaxComplete()
函数的具体用法:
以下代码请基于1.8之前版本的jQuery来运行(请注意,通过ajaxComplete()
设置的事件处理函数与通过$.ajax()
的complete
选项设置的回调函数,它们的参数是不同的)。
如果当前jQuery为1.8及以上版本,上述jQuery代码总共只会弹出一次对话框。因为从jQuery 1.8开始,ajaxComplete事件的处理函数必须绑定到document
对象上才能生效。
因此,不论当前jQuery为何版本,如果不是特殊需求,我们都应该将ajaxComplete事件的处理函数绑定到document
对象上。
0 条评论
撰写评论