巧用Ajax的beforeSend 提高用户体验

jQuery是经常使用的一个开源js框架，其中的$.ajax请求中有一个beforeSend方法，用于在向服务器发送请求前执行一些动作。

具体可参考jquery官方文档：http://api.jquery.com/Ajax_Events/

$.ajax({
    beforeSend: function(){
     // Handle the beforeSend event
    },
    complete: function(){
     // Handle the complete event
    }
    // ......
});

防止重复数据

在实际项目开发中，提交表单时常常由于网络或者其原因，用户点击提交按钮误认为自己没有操作成功，进而会重复提交按钮操作次数，如果页面前端代码没有做一些相应的处理，通常会导致多条同样的数据插入数据库，导致脏数据的增加。要避免这种现象，在$.ajax请求中的beforeSend方法中把提交按钮禁用掉，等到Ajax请求执行完毕，在恢复按钮的可用状态。

举个例子：

// 提交表单数据到后台处理
$.ajax({
    type: "post",
    data: studentInfo,
    contentType: "application/json",
    url: "/Home/Submit",
    beforeSend: function () {
        // 禁用按钮防止重复提交
        $("#submit").attr({ disabled: "disabled" });
    },
    success: function (data) {
        if (data == "Success") {
            //清空输入框
            clearBox();
        }
    },
    complete: function () {
        $("#submit").removeAttr("disabled");
    },
    error: function (data) {
        console.info("error: " + data.responseText);
    }
});

模拟Toast效果

ajax请求服务器加载数据列表时提示loading(“加载中，请稍后...”),

$.ajax({
    type: "post",
    contentType: "application/json",
    url: "/Home/GetList",
    beforeSend: function () {
        $("loading").show();
    },
    success: function (data) {
        if (data == "Success") {
            // ...
        }
    },
    complete: function () {
        $("loading").hide();
    },
    error: function (data) {
        console.info("error: " + data.responseText);
    }
});

通过调用一个函数展示有好的动画效果

<script type="text/javascript">

function test_ajax(){
   $.ajax(
   {
      type:"GET",//通常会用到两种：GET,POST。默认是：GET
      url:"a.php",//(默认: 当前页地址) 发送请求的地址
      dataType:"html",//预期服务器返回的数据类型。
      beforeSend:beforeSend, //发送请求
      success:callback, //请求成功
      error:error,//请求出错
      complete:complete//请求完成
   });
}
function error(XMLHttpRequest, textStatus, errorThrown){
  // 通常情况下textStatus和errorThown只有其中一个有值
  $("#showResult").append("<div>请求出错啦！</div>");
}
function beforeSend(XMLHttpRequest){
  $("#showResult").append("<div><img src='loading.gif' /><div>");
}
function complete(XMLHttpRequest, textStatus){
  $("#showResult").remove();
}
function callback(msg){
  $("#showResult").append("<div>请求成功，回传数:"+msg+"<div>");
}
</script>

事件的顺序如下：

ajaxStart 全局事件

开始新的Ajax请求，并且此时没有其他ajax请求正在进行。

beforeSend 局部事件

当一个Ajax请求开始时触发。如果需要，你可以在这里设置XHR对象。

ajaxSend 全局事件

请求开始前触发的全局事件

success 局部事件

请求成功时触发。即服务器没有返回错误，返回的数据也没有错误。

ajaxSuccess 全局事件

全局的请求成功

error 局部事件

仅当发生错误时触发。你无法同时执行success和error两个回调函数。

ajaxError 全局事件

全局的发生错误时触发

complete 局部事件

不管你请求成功还是失败，即便是同步请求，你都能在请求完成时触发这个事件。

ajaxComplete 全局事件

全局的请求完成时触发

ajaxStop 全局事件

当没有Ajax正在进行中的时候，触发。