jQuery.ajax（options ）

优质

小牛编辑

137浏览

2023-12-01

描述 (Description)

jQuery.ajax( options )方法使用HTTP请求加载远程页面。

$ .ajax（）返回它创建的XMLHttpRequest。在大多数情况下，您不需要直接操作该对象，但如果您需要手动中止请求，则可以使用该对象。

语法 (Syntax)

以下是使用此方法的简单语法 -

<i>$</i>.ajax( options )

参数 (Parameters)

以下是此方法使用的所有参数的说明 -

options - 配置Ajax请求的一组键/值对。所有选项都是可选的。

<!--

Here is the list of option which could be used as key/value pairs. Except URL, rest of the parameters are optional − -->

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>