jQuery.holdReady() 能暫停或恢復 jQuery 的 ready 事件。呼叫它之後,即使 DOM 已經解析完成,ready 的處理函式也會被扣住不執行,直到你主動放行。
最典型的場景是動態腳本載入。假設你的初始化邏輯依賴某個稍後才透過 Ajax 或動態 script 標籤載入的函式庫,若 ready 早早就跑完,那段程式就會因為找不到依賴而失敗。用 holdReady 把 ready 按住,等腳本載好再放行,順序就可控了。
jQuery.holdReady(hold)
參數 hold 為 true 時延後 ready 事件;為 false 時解除延後。這個方法可以多次呼叫,每一次 holdReady(true) 都會累加一層延後,必須逐一以 holdReady(false) 對消,ready 才會真正觸發。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>holdReady() 方法</title>
<script type="text/javascript" src="jquery-1.8.3.js"></script>
<script type="text/javascript">
jQuery.holdReady(true);
$(document).ready(function(){
alert("我不會被彈出");
});
</script>
</head>
<body>
</body>
</html>
由於加了 holdReady(true),即使文件載入完成,那個 alert 永遠不會出現。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>holdReady() 方法</title>
<script type="text/javascript" src="jquery-1.8.3.js"></script>
</head>
<body>
<button id="first">點擊測試彈出</button>
<button id="second">解除延遲</button>
<script type="text/javascript">
jQuery.holdReady(true);
$(document).ready(function(){
$("#first").click(function(){
alert("我不會被彈出");
});
});
$("#second").click(function(){
jQuery.holdReady(false);
});
</script>
</body>
</html>
一開始點擊第一個按鈕不會有任何反應,因為事件根本還沒綁上;按下「解除延遲」之後,ready 才執行、事件才綁定,此時第一個按鈕就正常了。
holdReady 是個槓桿很長的工具,用錯反而更難查問題。有兩點要牢記:一是務必成對使用,任何一條 holdReady(true) 沒有對應的 false,整個頁面的初始化都會停擺,而且不會報錯,排查起來相當痛苦;二是解除的時機最好寫在成功與失敗兩條路徑上(例如 Ajax 的 done 與 fail 都呼叫一次),避免請求失敗時 ready 永遠等不到放行。