jQuery.ajax(options )
描述 (Description)
jQuery.ajax( options )方法使用HTTP请求加载远程页面。
$ .ajax()返回它创建的XMLHttpRequest。 在大多数情况下,您不需要直接操作该对象,但如果您需要手动中止请求,则可以使用该对象。
语法 (Syntax)
以下是使用此方法的简单语法 -
<i>$</i>.ajax( options )
参数 (Parameters)
以下是此方法使用的所有参数的说明 -
options - 配置Ajax请求的一组键/值对。 所有选项都是可选的。
Sr.No. | 选项和说明 |
---|---|
1 | async 一个布尔值,指示是否异步执行请求。 默认值是true。 |
2 | beforeSend 在发送请求之前执行的回调函数。 |
3 | complete 每当请求完成时执行的回调函数。 |
4 | contentType 包含要为请求设置的MIME内容类型的字符串。 默认值为application/x-www-form-urlencoded。 |
5 | data 随请求一起发送到服务器的映射或字符串。 |
6 | dataFilter 用于处理XMLHttpRequest的原始响应数据的函数。 这是一个用于清理响应的预过滤功能。 |
7 | dataType 一个字符串,用于定义从服务器返回的数据类型(xml,html,json或script)。 |
8 | error 如果请求失败则执行的回调函数。 |
9 | global 一个布尔值,指示此请求是否将触发全局AJAX事件处理程序。 默认值是true。 |
10 | ifModified 一个布尔值,指示服务器在响应请求之前是否应检查页面是否已被修改。 |
11 | jsonp 覆盖jsonp请求中的回调函数名称。 |
12 | password 用于响应HTTP访问身份验证请求的密码。 |
13 | processData 一个布尔值,指示是否将提交的数据从对象表单转换为查询字符串形式。 默认值是true。 |
14 | success 如果请求成功则执行的回调函数。 |
15 | timeout 请求将在失败时超时的毫秒数。 |
16 | timeout 设置请求的本地超时(以毫秒为单位)。 |
17 | type 定义用于请求的HTTP方法的字符串(GET或POST)。 默认值为GET。 |
18 | url 包含发送请求的URL的字符串。 |
19 | username 用于响应HTTP访问身份验证请求的用户名。 |
20 | xhr 用于创建XMLHttpRequest对象的回调。 可用时默认为ActiveXObject(IE),否则为XMLHttpRequest。 |
例子 (Example)
假设我们在result.html文件中有以下HTML内容 -
<h1>THIS IS RESULT...</h1>
以下是一个简单的示例,简单地显示了此方法的用法。 这里我们使用success处理程序来填充返回的HTML -
<html>
<head>
<title>The jQuery Example</title>
<script type = "text/javascript"
src = "https://ajax.googleapis.com/ajax/libs/jquery/2.1.3/jquery.min.js">
</script>
<script type = "text/javascript" language = "javascript">
$(document).ready(function() {
$("#driver").click(function(event){
$.ajax( {
url:'result.html',
success:function(data) {
$('#stage').html(data);
}
});
});
});
</script>
</head>
<body>
<p>Click on the button to load result.html file:</p>
<div id = "stage" style = "background-color:blue;">
STAGE
</div>
<input type = "button" id = "driver" value = "Load Data" />
</body>
</html>