jQuery jQuery.ajax( options ) 方法

描述

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

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

语法

以下是使用该方法的简单语法：

$.ajax( options )

参数

这里是该方法使用的所有参数的描述：

options - 一个包含配置Ajax请求的键值对集合。所有选项都是可选的。

序号	选项与描述
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。

示例

假设我们在result.html文件中有以下的HTML内容-

<h1>THIS IS RESULT...</h1>

以下是一个简单示例，展示了这个方法的用法。在这里，我们使用成功处理程序来填充返回的HTML −

<html>
   <head>
      <title>The jQuery Example</title>
      <script type = "text/javascript" 
         src = "https://www.tutorialspoint.com/jquery/jquery-3.6.0.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>

这将产生以下结果−

jQuery jQuery.ajax( options ) 方法