這個方法不是用在自己的項目裡的——自己的代碼,什麼時候插入元素你心裡清楚。它真正派上用場的地方是:你無法修改源代碼,只能想辦法監視元素的出現。
比如換博客主題。原本以為加幾行 JS 改樣式就完事,寫完刷新卻發現沒生效,打開 Network 一看才明白:那些元素是 Ajax 後加載的,並不在首次 HTML 裡。典型的例子就是評論框的「提交評論」按鈕、側欄的搜索框。
$("#btn_comment_submit").removeClass("comment_btn").addClass("btn"); // 提交按鈕
$(".div_my_zzk").addClass("input-append"); // 搜索框
$(".btn_my_zzk").removeClass("btn_my_zzk").addClass("btn"); // 搜索按鈕
DOM 就緒時這些元素還不存在,選擇器返回空集合,jQuery 靜靜地什麼也不做——不報錯,也不生效,這種沉默最費時間。
思路很樸素:如果沒選到,就隔一會兒再選一次。
jQuery.fn.wait = function (func, times, interval) {
var _times = times || -1, // 檢測次數,-1 表示不限
_interval = interval || 20, // 檢測間隔(毫秒)
_self = this,
_selector = this.selector, // 記住原選擇器
_iIntervalID;
if (this.length) { // 已經選到了,直接執行
func && func.call(this);
} else {
_iIntervalID = setInterval(function () {
if (!_times) { // 次數用完(為 0)退出
clearInterval(_iIntervalID);
}
_times <= 0 || _times--; // 正數則遞減
_self = $(_selector); // 用原選擇器重新查詢
if (_self.length) { // 選到了
func && func.call(_self);
clearInterval(_iIntervalID);
}
}, _interval);
}
return this;
};
三個參數:func 是回調,元素出現後執行;times 是最大檢測次數,默認 -1 一直等;interval 是間隔,默認 20 毫秒。
$("#btn_comment_submit").wait(function () {
// 這裡的 this 就是 $("#btn_comment_submit")
this.removeClass("comment_btn").addClass("btn");
});
$("#widget_my_zzk").wait(function () {
$(".div_my_zzk").addClass("input-append");
$(".btn_my_zzk").removeClass("btn_my_zzk").addClass("btn");
});
依然不破壞 jQuery 的鏈式調用,$("#id").wait(fn).hide() 語法上完全成立——不過元素都還沒出現,鏈下去的 hide 也沒意義,這個問題就先放著了。
this.selector 在 jQuery 3.0 中已被移除。如果目標環境是新版 jQuery,需要改成顯式傳選擇器:$.fn.wait = function (sel, func, times, interval)。
輪詢不是唯一方案。現代浏覽器支持 MutationObserver,可以在 DOM 變化時回調,比定時輪詢更省資源也更即時:
var mo = new MutationObserver(function (recs, obs) {
var el = document.querySelector("#btn_comment_submit");
if (el) {
el.classList.remove("comment_btn");
el.classList.add("btn");
obs.disconnect();
}
});
mo.observe(document.body, { childList: true, subtree: true });
記得上限。不設 times 上限的無限輪詢,在元素永遠不會出現的情況下會一直跑下去,白白消耗 CPU。實戰中給個合理次數(比如 100 次 × 20 毫秒 = 2 秒)更穩妥。