如何控制jquery的ready事件

蚊子前端博客
发布于 2015/06/27 06:00
通常我们使用jquery的ready事件时,是希望在页面加载完成时再执行,可是有时候还得希望等待其他资源加载完毕后才触发ready事件

1. 遇到的情况 #

通常我们在使用jquery中的ready事件时,是在页面加载完成后触发的,防止因为页面没加载完成而获取不到DOM元素。如下面的例子:

<!DOCTYPE html>
<html lang="en">
	<meta charset="UTF-8">
	<title>deom</title>
	<script type="text/javascript" src="http://code.jquery.com/jquery-2.1.2.js"></script>
	<script type="text/javascript">
		$(function(){
			// 页面加载完成后再获取content元素
			console.log($('#content').html());
		// 获取不到元素
		console.log($('#main').html());
	</script>
</head>
	<div id="content">this is content</div>
	<div id="main">this is main</div>
</body>
</html>

像上面的情况,当页面中的DOM元素加载完成时,会自动触发ready事件。比如下面的例子中,肯定是首先输出ready,然后再输出timeout。可是,有时候我们得需要等待其他元素加载完成后才能触发ready事件,即先输出timeout,然后再输出ready,这时应该怎么办呢?

setTimeout(function(){
	console.log("timeout");
}, 500)
$(function(){
	console.log("ready");

2. 延迟ready执行的方法 #

下面有几种延迟ready执行的方法。

2.1 修改ready方法的位置 #

js一般情况下是按照上下顺序执行的,我们可以根据这种设定来延迟ready的执行。

$('#submit').click(function(){
	// 执行ready
	$(function(){
		console.log("ready");

点击submit元素之后再触发ready。

2.2 使用$.holdReady() #

上面的代码虽然能在click之后再触发ready方法,但是这样写毕竟不好,若ready里的内容很多呢?那逻辑就比较乱了。其实,在jquery中已经提供了延迟ready方法执行的办法了:$.holdReady()。还是使用第1节的例子:

setTimeout(function(){
	console.log("timeout");
	// 释放ready方法,开始执行
	$.holdReady(false);
}, 500)
// 把ready方法hold住,暂时不让ready执行
$.holdReady(true);
$(function(){
	console.log("ready");

使用$.holdReady()就能先输出timeout,再输出ready,在setTimeout执行完毕后再执行ready。

$.holdReady(true)$.holdReady(false)都是成对出现,若ready需要等待多个请求完成后再执行,可以这样写:

setTimeout(function(){
	console.log('timeout0');
    $.holdReady(false);
}, 500);
setTimeout(function(){
    console.log('timeout1');
    $.holdReady(false);
}, 500);
setTimeout(function(){
    console.log('timeout2');
    $.holdReady(false);
}, 500);
$.holdReady(true);
$.holdReady(true);
$.holdReady(true);
$(function(){
    console.log('ready');

上面的代码是三个setTimeout都执行完毕后再执行ready。

2.3 使用$.readyWait #

在2.2中,若需要等待多个请求时,得写好几个$.holdReady(true),不过可以换一种方式,使用$.readyWait来进行控制,把$.readyWait的值设置为限制的次数+1就行。为什么要+1呢?因为在jquery的源码里,就会直接执行一次ready方法,因此$.readyWait也需要把把这个次数也得算上。上面的代码也可以写成这样:

setTimeout(function(){
	console.log('timeout0');
    $.holdReady(false);
}, 500);
setTimeout(function(){
    console.log('timeout1');
    $.holdReady(false);
}, 600);
setTimeout(function(){
    console.log('timeout2');
    $.holdReady(false);
}, 700);
$.readyWait = 4;
$(function(){
    console.log('ready');

3. 源码中对$.holdReady的实现 #

其实$.holdReady()在源码也是操作的$.readyWait的值,$.holdReady(true)让$.readyWait的值+1,$.holdReady(false)让$.readyWait的值-1,当$.readyWait的值为1时就触发ready。$.readyWait的默认值是1,所以默认会直接触发ready的。

jQuery.extend({
	// 表示ready方法是否正在执行,若正在执行,则将isReady设置为true
	isReady: false,
	// ready方法执行前需要等待的次数
	readyWait: 1,
	// hold或者释放ready方法,若参数为true则readyWait++,否则执行ready,传入参数为true
	holdReady: function( hold ) {
		if ( hold ) {
			jQuery.readyWait++;
		} else {
			jQuery.ready( true );
	// 当DOM加载完毕时开始执行ready
	ready: function( wait ) {
		// 若传入的参数为true,则--readyWait;否则判断isReady,即ready是否正在执行  
		if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) {
			return;
		// Remember that the DOM is ready
		jQuery.isReady = true;
		// 若readyWait-1后还是大于0,则返回,不执行ready。
		if ( wait !== true && --jQuery.readyWait > 0 ) {
			return;
		// If there are functions bound, to execute
		readyList.resolveWith( document, [ jQuery ] );
		// 触发ready方法,然后解除绑定的ready方法。
		if ( jQuery.fn.triggerHandler ) {
			jQuery( document ).triggerHandler( "ready" );
			jQuery( document ).off( "ready" );

从$.holdReady的函数体可以看出,$.holdReady(true)是让$.readyWait++,而$.holdReady(false)是执行$.ready(true);

holdReady: function( hold ) {
	if ( hold ) {
		jQuery.readyWait++;
	} else {
		jQuery.ready( true );

那么让我们来分析一下ready中的流程控制:

4. 总结 #

我们再回到刚开始的那个例子:

setTimeout(function(){
	console.log("timeout");
	$.holdReady(false);
}, 500)
$.holdReady(true);
$(function(){