.load()

.load( handler(eventObject) ) 返回: jQuery

描述: 为 "load" 事件绑定一个处理函数。

  • version added: 1.0.load( handler(eventObject) )

    handler(eventObject)每次事件触发时会执行的函数。

  • version added: 1.4.3.load( [ eventData ], handler(eventObject) )

    eventData将要传递给事件处理函数的数据映射。

    handler(eventObject)每次事件触发时会执行的函数。

这个方法是 .bind('load', handler) 的快捷方式。

当所有子元素已经被完全加载完成时,load事件被发送到这个元素。此事件可以被发送到跟一个URL关联的任何元素:images, scripts, frames, iframes, window 对象。

如果图像是从浏览器缓存中加载,Load事件有可能不会触发。为了考虑这种可能性,如果图像已准备就绪,我们可以使用一个特殊的立即触发的loda触发事件。event.special.load目前可以作为一个可用的插件

例子,考虑了一个简单的图片页面:

<img src="book.png" alt="Book" id="book" />

事件处理器可以绑定到图像上:

$('#book').load(function() {
  // Handler for .load() called.
});

只要图像已被加载,该处理程序被调用。

在一般情况下,没有必要等待所有图像完全装入。如果代码可以更早的执行,通常最好把它在发送到.ready()方法处理。

Ajax的模块也有一个方法命名.load() 。哪一个是被执行取决于传递给它的参数设置。

Examples:

Example: 页面完全加载包括图形时,运行函数。

$(window).load(function () {
  // run code
});

Example: 对每个图片加载完成时,高度大于100的所有图像添加类bigImg。

$('img.userIcon').load(function(){
  if($(this).height() > 100) {
    $(this).addClass('bigImg');
  }
});
jQuery 1.6 API 中文版脚本之家整理、修订 (2011年6月)