〓 Ajax - 常规用法 参考:jQuery.ajax() | jQuery API Documentation $.ajax({ url: "test.html", type: "GET", timeout: 2000, contentType: "application/x-www-form-urlencoded", async: true, cache: false, data: {}, dataType: "json", statusCode: { 404: function() { alert('page not found'); } }, dataFilter: function (data, type) { // 对Ajax返回的原始数据进行预处理 return data // 返回处理后的数据 }, beforeSend: function(){ // Handle the beforeSend event }, success: function(data, textStatus, jqXHR){ $("#results").append(html); }, error: function (XMLHttpRequest, textStatus, errorThrown) { // 通常 textStatus 和 errorThrown 之中只有一个会包含信息 }, complete: function (XMLHttpRequest, textStatus) { } }); 〓 settings - option 说明 ◆ url - String 类型。(默认: 当前页地址) 发送请求的地址。 ◆ type - String 类型。(默认: "GET") 请求方式 ("POST" 或 "GET"), 默认为 "GET"。 注意:其它 HTTP 请求方法,如 PUT 和 DELETE 也可以使用,但仅部分浏览器支持。 ◆ timeout - Number 类型。设置请求超时时间(毫秒)。此设置将覆盖全局设置。 ◆ contentType - String 类型。(默认: "application/x-www-form-urlencoded") 发送信息至服务器时内容编码类型。默认值适合大多数情况。 如果你明确地传递了一个 content-type 给 $.ajax(), 那么他必定会发送给服务器(即使没有数据要发送) ◆ async - Boolean类型,(默认: true) 默认设置下,所有请求均为异步请求。 如果需要发送同步请求,请将此选项设置为 false。 注意,同步请求将锁住浏览器,用户其它操作必须等待请求完成才可以执行。 ◆ cache - Boolean类型,(默认: true, 当dataType为script和jsonp时默认为false) jQuery 1.2 新功能,设置为 false 将不缓存此页面。 ◆ data - Object 或者 String 类型。发送到服务器的数据。 将自动转换为请求字符串格式。GET 请求中将附加在 URL 后。 查看 processData 选项说明以禁止此自动转换。 必须为 Key/Value 格式。如果为数组,jQuery 将自动为不同值对应同一个名称。 如 {foo:["bar1", "bar2"]} 转换为 "&foo=bar1&foo=bar2"。 ◆ dataType - String 类型。预期服务器返回的数据类型。 如果不指定,jQuery 将自动根据 HTTP 包 MIME 信息来智能判断, 比如XML MIME类型就被识别为XML。 ◆ statusCode - Map 类型。默认: {}。一组数值的HTTP代码和函数对象,当响应时调用了相应的代码。 例如,如果响应状态是404,将触发以下警报: statusCode: { 404: function() { alert('page not found'); } }, ◆ dataFilter - 给 Ajax 返回的原始数据的进行预处理的函数。 提供 data 和 type 两个参数: data是Ajax返回的原始数据,type是调用jQuery.ajax时提供的 dataType参数。 函数返回的值将由jQuery进一步处理。 ◆ beforeSend - 发送请求前可修改 XMLHttpRequest 对象的函数,如添加自定义 HTTP 头。 XMLHttpRequest 对象是唯一的参数。这是一个 Ajax 事件。 如果返回false可以取消本次ajax请求。 ◆ success - Function,Array类型。请求成功后的回调函数。 参数:由服务器返回,并根据 dataType 参数进行处理后的数据; 描述状态的字符串textStatus。 还有 jqXHR(在jQuery 1.4.x的中,XMLHttpRequest) 对象 。 在jQuery 1.5, 成功设置可以接受一个函数数组。每个函数将被依次调用。 ◆ error - 请求失败时调用此函数。 有以下三个参数:XMLHttpRequest 对象、错误信息、(可选)捕获的异常对象。 如果发生了错误,错误信息(第二个参数)除了得到 null 之外, 还可能是"timeout", "error", "notmodified" 和 "parsererror"。 ◆ complete - 请求完成后回调函数 (请求成功或失败之后均会调用)。
Ajax - 常规使用settings选项说明
于 2025-01-19 21:31:32 首次发布