jQuery ajax模板及各参数介绍

Ajax简介:

Ajax 即“Asynchronous Javascript And XML”(异步 JavaScript 和 XML),是指一种创建交互式网页应用的网页开发技术。

Ajax = 异步 javaScript 和 XML(标准通用标记语言的子集)。

Ajax 是一种用于创建快速动态网页的技术。

Ajax 是一种在无需重新加载整个网页的情况下,能够更新部分网页的技术。

通过在后台与服务器进行少量数据交换,Ajax 可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。

传统的网页(不使用 Ajax)如果需要更新内容,必须重载整个网页页面。


一、常用的比较通用ajax请求模板:

$.ajax({    
    url: "/base/data",  //请求的url  
    type: "GET",   //请求方式    
    dataType: "jsonp",   //返回格式为json 
    contentType: 'application/json;charset=UTF-8', //发送给服务器的格式,默认application/x-www-form-urlencoded
    jsonp: "jsonpCallback",   //服务端用于接收callback调用的function名的参数    
    async: true,    //请求是否异步,默认为异步,ajax重要特性    
    cache : false,  //不会从浏览器缓存中加载请求信息
    timeout:5000,    //超时时间
    data: { "id": "value" },    //传递参数值
    headers: {
        Accept: "application/json; charset=utf-8"
    },   
    beforeSend:function(XMLHttpRequest){
       //请求前的处理
    },
    success:function(data, textStatus){
        //请求成功时...   
    },
    error:function(XMLHttpRequest, textStatus, errorThrown){
       //请求出错... 
    },      
    complete: function(XMLHttpRequest, textStatus) {        
      //请求完成,成功失败均调用...  
    }   
    
});

二、ajax方法请求参数

1.url

类型:String

默认为当前地址发送请求的页面。

2.type

类型:String

请求方式:(post或get)默认为get。

其它 HTTP 请求方法,如 PUT 和 DELETE 也可以使用,但仅部分浏览器支持。

3.timeout

类型:Number

设置请求超时时间(毫秒)。此设置将覆盖$.ajaxSetup()方法的全局设置。

4.async

类型:Boolean

默认设置为true,所有请求均为异步请求。如果需要同步请求,请将此选项设置为false。

5.cache

类型:Boolean

默认为true(当dataType为Script时,默认为false),设置false将不会从浏览器缓存中加载请求信息

6.data

类型:Object  / String

发送到服务器的数据。将自动转换为请求字符串格式。GET 请求中将附加在 URL 后。

查看 processData 选项说明以禁止此自动转换。必须为 Key/Value 格式。

如果为数组,jQuery 将自动为不同值对应同一个名称。 如 {foo:["bar1", "bar2"]} 转换为 '&foo=bar1&foo=bar2'。

7.dataType

类型:String

预期服务器返回的数据类型。如果不指定,jQuery将自动根据HTTP包的mine信息返回responseXML或responseText,并作为回调函数参数传递。

数据类型如下:

  1. xml:返回XML文档,可用jQuery处理。
  2. html:返回纯文本HTML信息;包含的script标签会在插入DOM时执行。
  3. script:返回纯文本javascript代码。不会自动缓存结果,除非设置了cache参数。注意在远程请求时(不在同一个域下),所有post请求都将转为get请求。
  4. json:返回JSON数据。
  5. jsonp:JSON格式。使用JSONP形式调用函数时,例如myurl?callback=?,JQuery将自动替换后一个“?”为正确的函数名,以执行回调函数。
  6. text:返回纯文本字符串。

8.success

类型:Function

请求成功后调用的回调函数,有两个参数。

参数:

  (1)data 由服务器返回,并根据dataType参数进行处理后的数据。

  (2)textStatus描述状态的字符串。

  function(data, textStatus){

    //data可能是 xmlDoc, jsonObj, html, text, etc... 

    this;  //调用本次ajax请求时传递的options参数

  }

9.error

类型:Function

请求失败时被调用的函数。该函数有3个参数。

参数:

(1)XMLHttpRequest对象

(2)错误信息

(3)捕获的错误对象(可选)

  function(XMLHttpRequest, textStatus, errorThrown){

    //通常情况下textStatus和errorThrown只有其中一个包含信息

    this;    //调用本次ajax请求时传递的options参数

  }

10.contentType

类型:String

当发送信息至服务器时。设置内容编码类型。

默认为  "application/x-www-form-urlencoded"   该默认值适合大多数应用场合。

11.beforeSend

类型:Function

发送请求前可以修改XMLHttpRequest对象的函数,

例如添加自定义HTTP头。在beforeSend中如果返回false可以取消本次ajax请求。XMLHttpRequest对象是唯一的参数。

  function(XMLHttpRequest){

    this;//调用本次ajax请求时传递的options参数

  }

12.complete

类型:Function

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

参数:

(1)XMLHttpRequest对象

(2)描述成功请求类型的字符串。

  function(XMLHttpRequest, textStatus){

    this;    //调用本次ajax请求时传递的options参数

  }

13.dataFilter

类型:Function

给Ajax返回的原始数据进行预处理的函数。提供data和type两个参数

(1)data是Ajax返回的原始数据

(2)type是调用$.ajax() 时提供的dataType参数。函数返回的值将由jQuery进一步处理。

  function(data,type){

    //返回处理后的数据

    return data;

  }

14.global

类型:Boolean

默认为true。表示是否触发全局ajax事件。

设置为false将不会触发全局ajax事件,

ajaxStart和ajaxStop可用于控制各种ajax事件。

15.ifModified

类型:Boolean

默认为false。仅在服务器数据改变时获取新数据。服务器数据改变判断的依据是Last-Modified头信息。默认值是false,即忽略头信息。

16.jsonp

类型:String

在一个jsonp请求中重写回调函数的名字。

该值用来替代在"callback=?"这种GET或POST请求中URL参数里的"callback"部分,

例如:{jsonp:'onJsonPLoad'} 会导致将 "onJsonPLoad=?" 传给服务器。

17.username

类型:String

用于响应HTTP访问认证请求的用户。

18.password

类型:String

用于响应HTTP访问认证请求的密码。

19.processData

类型:Boolean

默认为true。发送的数据将被转换为对象(从技术角度来讲而非字符串)以配合默认内容类型"application/x-www-form-urlencoded"。如果要发送DOM树信息或者其他不希望转换的信息,请设置为false。

20.scriptCharset

类型:String

只有当请求时dataType为"jsonp"或者"script",并且type是GET时才会用于强制修改字符集(charset)。通常在本地和远程的内容编码不同时使用。

 

 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值