jQuery.holdReady()

所属分类：核心 API | 内部属性 > 全局 jQuery 对象的属性 | 事件 > 文档加载 英文文档：jQuery.holdReady()

jQuery.holdReady( hold )返回: undefined

描述: 暂停或恢复.ready() 事件的执行。

  • 添加的版本: 1.6jQuery.holdReady( hold )

    • hold
      类型: Boolean
      指示是否暂停或恢复被请求的ready事件

在$.holdReady()方法允许调用者延迟jQuery的ready事件。这种先进的功能，通常会被用来允许在 ready 事件发生之前，动态加载其它的 JavaScript，例如 jQuery 插件，即使 DOM 可能已经准备就绪。该方法必须在文档早期被调用，例如，在 <head> 中加载完 jQuery 脚本之后，立刻调用该方法。如果在 ready 事件已经被调用后再调用该方法，将不会起作用。

为了延迟 ready 事件，首先要调用 $.holdReady(true)，当 ready 事件准备执行时，再调用 $.holdReady(false) 。注意，在 ready 事件中可以设置多个 hold。每一个都对应一次 $.holdReady(true) 调用。直到所有的 hold 都被释放，也就是调用了对应数量的 $.holdReady(false)之后，并且满足正常的文档 ready 条件时，ready 事件才会被真正执行。（见ready的更多信息。）)

例子:

延迟就绪事件，直到已加载的插件。

1
2
3
4
 
$.holdReady(true);
$.getScript("myplugin.js", function() {
  $.holdReady(false);
});