jQuery.ajaxSetup()


jQuery.ajaxSetup( options )返回:

描述: 为以后要用到的Ajax请求设置默认的值

  • 添加的版本: 1.1jQuery.ajaxSetup( options )

    • options
      类型: PlainObject
      一个用来配置Ajax请求的"{键:值}"对,所有的选项都是可选的。

用于设置$.ajaxSetup()的详细参数, 参见 $.ajax().

所有后面的 Ajax 调用任何函数都将使用新的设置参数,除非它们调用时设置了各自的参数重载了这个默认值。 直到下一次调用$.ajaxSetup().

注意: 此处指定的设置会影响所有 $.ajax或基于AJAX的衍生方法,如$.get()的调用。这可能会导致不良的行为因为其他调用(例如,插件)可能希望正常的默认设置。出于这个原因,我们强烈建议您不要使用此API。相反我们建议,在调用时明确设置选项或定义一个简单的插件。

举个例子,我们可以事先设置服务器重复响应的默认URL参数:

1
2
3
$.ajaxSetup({
url: 'ping.php'
});

现在每次Ajax请求将自动使用这个"ping.php" URL:

1
2
3
4
$.ajax({
// url not set here; uses ping.php
data: {'name': 'Dan'}
});

注意: 全局回调函数应使用他们各自的全局Ajax事件处理方法-.ajaxStart(), .ajaxStop(), .ajaxComplete(), .ajaxError(), .ajaxSuccess(), .ajaxSend()-设置,而不是为 $.ajaxSetup() 设置 options 对象。

例子:

设置 AJAX 请求默认地址为 "/xmlhttp/",禁止触发全局 AJAX 事件,用 POST 代替默认 GET 方法。其后的 AJAX 请求不再设置任何选项参数。

1
2
3
4
5
6
7
$.ajaxSetup({
url: "/xmlhttp/",
global: false,
type: "POST"
});
$.ajax({ data: myData });