您的位置: 首页  >  IT文章  >  jQuery系列：Ajax 1. load(url, [data], [callback]) 2. jQuery.get(url, [data], [callback], [type]) 3. jQuery.getJSON(url, [data], [callback]) 4. jQuery.post(url, [data], [callback], [type]) 5. jQuery.ajax([options]) 6. serialize()、serializeArray()及Param() 7. $.ajaxSetup()设置全局Ajax

jQuery系列：Ajax 1. load(url, [data], [callback]) 2. jQuery.get(url, [data], [callback], [type]) 3. jQuery.getJSON(url, [data], [callback]) 4. jQuery.post(url, [data], [callback], [type]) 5. jQuery.ajax([options]) 6. serialize()、serializeArray()及Param() 7. $.ajaxSetup()设置全局Ajax

分类: IT文章 • 2022-05-23 11:59:29

1.1 解析

　　载入远程 HTML 文件代码并插入至 DOM 中。

　　语法格式：

load(url, [data], [callback])

其中，参数

　　url：请求被加载的页面URL地址。

　　[data]：可选项参数，发送至服务器的数据，key/value格式。

　　[callback]：可选项参数，加载成功后返回至加载页面的回调函数。

load()方法默认使用 GET 方式，如果有[data]参数，则会自动转换为POST方式。

1.2 示例

　　示例1：load()方法加载全部请求页面HTML代码

　　Index.cshtml：

@{
    Layout = null;
}

<!DOCTYPE html>

<html>
<head>
    <meta name="viewport" content="width=device-width" />
    <title>Index</title>
    <script type="text/javascript" src="@Url.Content("~/Scripts/jquery-2.1.4.js")"></script>
    <script type="text/javascript">
        $(function () {
            $("#container").load("@Url.Action("About", "Home")");
        });
    </script>
</head>
<body>
    <div id="container">
    </div>
</body>
</html>

　　About.cshtml：

@{
    Layout = null;
}

<!DOCTYPE html>

<html>
<head>
    <meta name="viewport" content="width=device-width" />
    <title>About</title>
</head>
<body>
    <div>
        Index
    </div>
    <div id="about">
        About
    </div>
</body>
</html>
View Code

　　load()方法之后，container中的HTML代码：

<div id="container">
    <meta name="viewport" content="width=device-width">
    <title>About</title>
    <div>
        Index
    </div>
    <div id="about">
        About
    </div>
</div>

　　加载静态的HTML文件：

<script type="text/javascript">
    $(function () {
        $("#container").load("About.html");
    });
</script>

　　示例2：load()方法加载部分请求页面HTML代码

<script type="text/javascript">
    $(function () {
        $("#container").load("@Url.Action("About", "Home") div");
    });
</script>
<div id="container">
    <div>
        Index
    </div>
    <div id="about">
        About
    </div>
</div>
<script type="text/javascript">
    $(function () {
        $("#container").load("@Url.Action("About", "Home") #about");
    });
</script>
<div id="container">
    <div id="about">
        About
    </div>
</div>

　　加载静态的HTML文件部分代码：

<script type="text/javascript">
    $(function () {
        $("#container").load("About.html #about");
    });
</script>

　　示例3：data可选项参数

<script type="text/javascript">
    $(function () {
        $("#container").load("@Url.Action("About", "Home")", {
            _t: new Date(),      // 日期
            _r: Math.random()    // 随机数
        });
    });
</script>

　　示例4： callback可选项参数

<script type="text/javascript">
    $(function () {
        $("#container").load("@Url.Action("About", "Home")", {
            _t: new Date(),      // 日期
            _r: Math.random()    // 随机数
        }, function (data) {
            alert(data);         // data为url页面返回的结果
        });
    });
</script>

2. jQuery.get(url, [data], [callback], [type])

2.1 解析

　　通过远程 HTTP GET 请求载入信息。

　　语法格式：

jQuery.get(url, [data], [callback], [type])

其中，参数

　　url：请求被加载的页面URL地址。

　　[data]：可选项参数，发送至服务器的数据，key/value格式。

　　[callback]：可选项参数，加载成功后返回至加载页面的回调函数。

　　[type]：返回的内容格式，xml, html, script, json, text, _default，默认为html。

2.2 示例

<script type="text/javascript">
    $(function () {
        $.get("@Url.Action("About", "Home")");
    });
</script>
<script type="text/javascript">
    $(function () {
        $.get("@Url.Action("About", "Home")", {
            _t: new Date(),      // 日期
            _r: Math.random()    // 随机数
        });
    });
</script>
<script type="text/javascript">
    $(function () {
        $.get("@Url.Action("About", "Home")", {
            UserName: encodeURI($("#txtUserName").val())
        });
    });
</script>
<script type="text/javascript">
    $(function () {
        $.get("@Url.Action("About", "Home")", {
            _t: new Date(),      // 日期
            _r: Math.random()    // 随机数
        }, function (data) {
            alert(data);         // data为url页面返回的结果
        });
    });
</script>
<script type="text/javascript">
    $(function () {
        $.get("@Url.Action("About", "Home")", {
            _t: new Date(),      // 日期
            _r: Math.random()    // 随机数
        }, function (data) {
            alert(data);         // data为url页面返回的结果
        }, "json");
    });
</script>

　　参数[data]可以使用另外一种方式传递：

<script type="text/javascript">
    $(function () {
        $.get("@Url.Action("About", "Home")",
            "_r=" + Math.random()
            , function (data) {
                alert(data._r);
            }, "json");
    });
</script>
<script type="text/javascript">
    $(function () {
        $.get("@Url.Action("About", "Home")",
            "_t=" + new Date() + "&_r=" + Math.random()
            , function (data) {
                alert(data._r);
            }, "json");
    });
</script>

　　jQuery异步加载XML文档：

@{
    Layout = null;
}

<!DOCTYPE html>

<html>
<head>
    <meta name="viewport" content="width=device-width" />
    <title>Index</title>
    <script type="text/javascript" src="@Url.Content("~/Scripts/jquery-2.1.4.js")"></script>
    <script type="text/javascript">
        $(function () {
            $.get("@Url.Content("~/Content/Categories.xml")", {
                _r: Math.random()
            }, function (data) {
                var categories = "";
                $(data).find("Category").each(function () {
                    // 遍历获取的数据
                    var $category = $(this);
                    categories += "分类ID：" + $category.find("CategoryID").text() + "<br />";
                    categories += "分类名称：" + $category.find("CategoryName").text() + "<hr />";
                });
                // 显示数据
                $("#container").html(categories);
            }, "xml");
        });
    </script>
</head>
<body>
    <div id="container">
    </div>
</body>
</html>

　　Categories.xml：

<?xml version="1.0" encoding="utf-8" ?>
<Categories>
  <Category>
    <CategoryID>1</CategoryID>
    <CategoryName>书籍</CategoryName>
  </Category>
  <Category>
    <CategoryID>2</CategoryID>
    <CategoryName>数码电子</CategoryName>
  </Category>
  <Category>
    <CategoryID>3</CategoryID>
    <CategoryName>服装服饰</CategoryName>
  </Category>
</Categories>
View Code

3. jQuery.getJSON(url, [data], [callback])

3.1 解析

　　通过 HTTP GET 请求载入 JSON 数据。

　　语法格式：

jQuery.getJSON(url, [data], [callback])

其中，参数

　　url：请求被加载的页面URL地址。

　　[data]：可选项参数，发送至服务器的数据，key/value格式。

　　[callback]：可选项参数，加载成功后返回至加载页面的回调函数。

3.2 示例

@{
    Layout = null;
}

<!DOCTYPE html>

<html>
<head>
    <meta name="viewport" content="width=device-width" />
    <title>Index</title>
    <script type="text/javascript" src="@Url.Content("~/Scripts/jquery-2.1.4.js")"></script>
    <script type="text/javascript">
        $(function () {
            $.getJSON("/Home/Categories", {
                _r: Math.random()
            }, function (data) {
                //alert(data.length);
                var categories = "";
                $.each(data, function (i, item) {
                    categories += "分类ID：" + item.CategoryID + "<br />";
                    categories += "分类名称：" + item.CategoryName + "<hr />";
                });
                // 显示数据
                $("#container").html(categories);
            });
        });
    </script>
</head>
<body>
    <div id="container">
    </div>
</body>
</html>
public JsonResult Categories()
{
    List<Category> categories = new List<Category>() {
        new Category() { CategoryID = 1, CategoryName = "书籍" },
        new Category() { CategoryID = 2, CategoryName = "数码电子" },
        new Category() { CategoryID = 3, CategoryName = "服装服饰" }
    };
    return Json(categories, JsonRequestBehavior.AllowGet);
}
[{"CategoryID":1,"CategoryName":"书籍"},{"CategoryID":2,"CategoryName":"数码电子"},{"CategoryID":3,"CategoryName":"服装服饰"}]

4. jQuery.post(url, [data], [callback], [type])

4.1 解析

　　通过远程 HTTP POST 请求载入信息。

　　语法格式：

jQuery.post(url, [data], [callback], [type])

其中，参数

　　url：请求被加载的页面URL地址。

　　[data]：可选项参数，发送至服务器的数据，key/value格式。

　　[callback]：可选项参数，加载成功后返回至加载页面的回调函数。

　　[type]：返回的内容格式，xml, html, script, json, text, _default，默认为html。

4.2 示例

　　jQuery.post(url, [data], [callback], [type])的用法与jQuery.get(url, [data], [callback], [type])相同。

<script type="text/javascript">
    $(function () {
        $.post("@Url.Action("About", "Home")", {
            _t: new Date(),      // 日期
            _r: Math.random()    // 随机数
        });
    });
</script>

5. jQuery.ajax([options])

5.1 解析

　　通过 HTTP 请求加载远程数据。

　　$.ajax()是jQuery Ajax的最底层方法，也是功能最强的方法。$.get()、$.post()、$.getJSON()等都是在$.ajax()方法基础之上实现的。

　　语法格式：

jQuery.ajax([options])

其中，参数

　　[options]：$.ajax()方法中的请求设置，key/value格式。既包含发送请求的参数，也包含服务器响应后回调的数据。

　　$.ajax()方法的参数列表：

参数名 类型 描述
url String 发送请求的地址（默认为当前页面）
type String 数据请求方式（get/post），默认为get。
data String或Object 发送到服务器端的数据。将自动转换为请求字符串格式。在GET 请求方式中将附加在 URL 后。
dataType String 服务器返回的数据类型。如果未指定，jQuery自动根据HTTP包MIME信息返回 responseXML 或 responseText，作为参数传递给回调函数，可用类型：
html：返回纯文本的HTML信息，包含的 <Script>会在插入页面时被执行
script：返回纯文本的JavaScript代码
text：返回纯文本字符串
xml：返回可被jQuery处理的XML文档
json：返回JSON格式的数据
beforeSend Function

用于发送请求前修改XMLHttpRequest对象，其中的参数就是XMLHttpRequest对象，由于该函数本身是jQuery事件，如果函数返回false，则表示取消本次事件。
XMLHttpRequest 对象是唯一的参数。

function (XMLHttpRequest) {
　　this; // the options for this ajax request
}

complete Function

请求完成后调用的函数，该函数无论数据发送成功或失败都会调用，其中有两个参数：XMLHttpRequest对象和textStatus用于描述成功请求类型的字符串。

function (XMLHttpRequest, textStatus)  {
　　 this; // the options for this ajax request
}

success Function

请求成功后调用的回调函数，该函数有两个参数：根据参数dataType处理后服务器返回的数据data和textStatus描述状态的字符串。

function (data, textStatus) {
　　 this; // the options for this ajax request
}

error Function

请求失败后调用的回调函数，该函数有3个参数：XMLHttpRequest对象、出错信息和（可选）捕捉到的错误对象。

function (XMLHttpRequest, textStatus, errorThrown) {
       this; // 通常情况下textStatus和errorThown只有其中一个有值
}
timeout Number 请求超时的时间（毫秒），可以在$.ajaxSetup()方法中设置。
global Boolean 是否响应全局事件，默认为true，表示为响应。如果设置为false，则不响应全局事件，全局事件$.ajaxStart()等将不响应。
async Boolean 是否异步请求，默认为true，表示是异步，如果设置为false，表示同步请求。
cache Boolean 是否进行页面缓存，true表示进行缓存，false表示不进行缓存。

5.2 示例

<script type="text/javascript">
    $(function () {
        $.ajax({
            type: "GET",
            url: "/Home/CheckUserName",
            dataType: "html",
            data: "UserName=" + decodeURI($("#txtUserName").val()),
            beforeSend: function (XMLHttpRequest) {
                // show loading
            },
            success: function (data, textStatus) {

            },
            complete: function (XMLHttpRequest, textStatus) {
                // hide loading
            },
            error: function (XMLHttpRequest, textStatus, errorThrown) {
                // XMLHttpRequest.status
                // XMLHttpRequest.readyState
                // textStatus
            }
        });
    });
</script>

6. serialize()、serializeArray()及Param()

6.1 解析

　　serialize()序列化表单，只能对<form>标记中的带有name属性的元素序列化。

　　serialize()语法格式：

serialize()

　　该方法是将所选择的DOM元素转换成能随AJAX传递的字符串，即序列化所选择的DOM元素。

　　serialize()后的数据格式：

UserName=Libing&Password=1

　　serializeArray()序列化表格元素 (类似 serialize() 方法)，返回 JSON 数据结构数据，注意：此方法返回的是 JSON 对象而非 JSON 字符串。serializeArray() 方法通过序列化表单值来创建对象数组（名称和值）。

　　返回的 JSON 对象是由一个对象数组组成的，其中每个对象包含一个或两个名值对 —— name 参数和 value 参数

[
    { name: "UserName", value: "用户名" },
    { name: "Password", value: "密码" },
    { name: "Email" } // 值为空
]

　　serializeArray()语法格式：

serializeArray()

　　param() 方法：序列化一个 key/value 对象。

　　param() 方法创建数组或对象的序列化表示，该序列化值可在进行 AJAX 请求时在 URL 查询字符串中使用。

　　param() 方法用于在内部将元素值转换为序列化的字符串表示。

　　param()语法格式：

jQuery.param(object,traditional)

其中，参数

　　object：要进行序列化的数组或对象。

　　traditional：规定是否使用传统的方式浅层进行序列化（参数序列化）。

6.2 示例

<!DOCTYPE html>

<html>
<head>
    <meta name="viewport" content="width=device-width" />
    <title>Index</title>
    <script type="text/javascript" src="~/Scripts/jquery-2.1.4.js"></script>
    <script type="text/javascript">
        $(function () {
            $.get("@Url.Action("About", "Home")",
                $("#frm").serialize()
                , function (data) {
                    alert(data.UserName);
                }, "json");
        });
    </script>
</head>
<body>
    <form id="frm">
        <input name="UserName" type="text" value="用户名" />
        <input name="Password" type="text" value="密码" />
    </form>
    <div id="container">
    </div>
</body>
</html>
<script type="text/javascript">
    $(function () {
        $.get("@Url.Action("About", "Home")",
                $("#frm").serializeArray()
                , function (data) {
                    alert(data.UserName);
                }, "json");
    });
</script>
var fields = $("select, :radio").serializeArray();
$.each(fields, function (i, field) {
    $("#results").append(field.value + " ");
});
var params = { 1900, height:1200 };
var str = jQuery.param(params);
$("#results").text(str);

　　结果：

width=1680&height=1050

7. $.ajaxSetup()设置全局Ajax

7.1 解析

　　$.ajaxSetup()用于设置全局性的Ajax默认选项，一次设置，全局有效。

　　语法格式：

$.ajaxSetup([options])

其中，参数

　　[options]：可选项参数是一个对象，设置$.ajax()方法中的参数。

7.2 示例

<script type="text/javascript">
    $(function () {
        $.ajaxSetup({
            type: "POST",
            url: "/Home/Index",
            dataType:"json"
        });

        $.ajax({
            success: function (data) {
                // show data
            }
        });
    });
</script>

　　Ajax的其他全局事件：

事件名称 参数 功能描述
ajaxComplete(callback) callback Ajax请求完成时执行函数
ajaxError(callback) callback Ajax请求发生错误时执行函数，其中捕捉到的错误可以作为最后一个参数进行传递
ajaxSend(callback) callback Ajax请求发送前执行函数
ajaxStart(callback) callback Ajax请求开始时执行函数
ajaxStop(callback) callback Ajax请求结束时执行函数
ajaxSuccess(callback) callback Ajax请求成功时执行函数

　　ajaxStart()及ajaxStop全局事件示例：

<script type="text/javascript">
    $(function () {
        $("divLoading").ajaxStart(function () {
            $(this).html("正在处理中...").show();
        });
        $("divLoading").ajaxStop(function () {
            $(this).html("处理已完成").hide();
        });
    });
</script>

相关推荐