定义和用法
load() 方法通过 AJAX 请求从服务器加载数据,并把返回的数据放置到指定的元素中。
注释:还存在一个名为 load 的 jQuery 事件方法。调用哪个,取决于参数。
语法
load(url,data,function(response,status,xhr))
参数
描述
url
规定要将请求发送到哪个 URL。
data
可选。规定连同请求发送到服务器的数据。
function(response,status,xhr)
可选。规定当请求完成时运行的函数。
额外的参数:
response - 包含来自请求的结果数据
status - 包含请求的状态("success", "notmodified", "error", "timeout" 或 "parsererror")
xhr - 包含 XMLHttpRequest 对象
详细说明
该方法是最简单的从服务器获取数据的方法。它几乎与 $.get(url, data, success) 等价,不同的是它不是全局函数,并且它拥有隐式的回调函数。当侦测到成功的响应时(比如,当 textStatus 为 "success" 或 "notmodified" 时),.load() 将匹配元素的 HTML 内容设置为返回的数据。这意味着该方法的大多数使用会非常简单:
$("#result").load("ajax/test.html");
如果提供回调函数,则会在执行 post-processing 之后执行该函数:
$("#result").load("ajax/test.html", function() {
alert("Load was performed.");
});
上面的两个例子中,如果当前文档不包含 "result" ID,则不会执行 .load() 方法。
如果提供的数据是对象,则使用 POST 方法;否则使用 GET 方法。