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>

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

<html>
   <head>
      <title>The jQuery Example</title>
      <script type = "text/javascript" 
         src = "https://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-ajax.htm

打印页面