clearQueue() 的效果近似 stop(true),但語意更清楚。1.4 之後分工明確:stop() 主要用來中止動畫,clearQueue() 用來丟掉佇列中還沒跑的函式。它接受一個可選參數——佇列名稱,用來移除特定佇列。
<input id="start" type="button" value="開始運行動畫" />
<input id="stop" type="button" value="終止動畫" />
<div></div>
<script>
$("#start").click(function () {
$("div").show("slow");
$("div").animate({ left: '+=200' }, 5000);
$("div").queue(function () {
$(this).addClass("newcolor");
$(this).dequeue();
});
$("div").animate({ left: '-=200' }, 1500);
$("div").queue(function () {
$(this).removeClass("newcolor");
$(this).dequeue();
});
$("div").slideUp();
});
$("#stop").click(function () {
$("div").clearQueue(); // 丟掉尚未執行的動畫與佇列函式
$("div").stop(); // 中止當前動畫
});
</script>
建議動手把這兩行其中一行註解掉,實際跑一次就能體會 clearQueue() 與 stop() 的差別:少了 clearQueue(),動畫雖然停了,但後續排隊的步驟還是會接著播放。
接受兩個 DOM 元素作為參數(注意不是 jQuery 物件):
jQuery.contains(document.documentElement, document.body); // true
jQuery.contains(document.body, document.documentElement); // false
兩個參數:第一個是延遲毫秒數,第二個是佇列名稱(可選)。
<p><button>運行</button></p>
<div class="first"></div>
<div class="second"></div>
<script>
$("button").click(function () {
$("div.first").slideUp(300).delay(800).fadeIn(400); // 收起後等 800ms 再淡入
$("div.second").slideUp(300).fadeIn(400); // 對照組,中間沒有停頓
});
</script>
綠色那層在隱藏後會停 800 毫秒才淡入,這在過去只能靠 setTimeout 硬寫。
作用近似 remove(),但更強大——它在移除的同時會回傳被移除的元素,且保留該元素上的事件與 jQuery 資料,讓你可以稍後原封不動放回 DOM。
<button>添加/刪除段落</button>
<p>這是一個用於測試的段落</p>
<script>
var p;
$("button").click(function () {
if (p) {
p.appendTo("body"); // 放回
p = null;
} else {
p = $("p").detach(); // 移除並保留在變數裡
}
});
</script>
若改用 remove(),元素上的事件綁定會一起被清掉,放回後就失效了——這正是 detach() 存在的意義。
接受選擇器或 DOM 元素,只保留「確實包含該子節點」的項目。
<ul>
<li>測試1</li>
<li>測試2
<ul><li>測試2.1</li><li>測試2.2</li></ul>
</li>
<li>測試3</li>
<li>測試4</li>
</ul>
<script>
$('li').has('ul').css('background-color', 'red');
</script>
結果只有巢狀了 ul 的那個 li 會被上色。
jQuery.isEmptyObject({}); // true
jQuery.isEmptyObject({ foo: "bar" }); // false
jQuery.isPlainObject({}); // true
jQuery.isPlainObject("test"); // false
next() 只能取下一個,siblings() 又抓太多,1.4 補上了這個中間地帶。
<dl>
<dt>dt1</dt>
<dd>dd1</dd><dd>dd2</dd><dd>dd3</dd><dd>dd4</dd>
<dt id="term-2">dt2</dt>
<dd>dd1</dd><dd>dd2</dd><dd>dd3</dd>
<dt>dt3</dt>
<dd>dd1</dd><dd>dd2</dd>
</dl>
<script>
$('#term-2').nextUntil('dt').css('background-color', 'red');
</script>
只會選中 #term-2 之後的 dd,一遇到下一個 dt 就停止選取。這在處理定義列表、FAQ 分組時非常順手。
有 nextUntil() 自然也有 prevUntil(),方向相反,這裡不再示範。
寫插件時拿來當預設回呼很好用,可以避免到處寫 if (typeof callback == "function") 的判斷。
與 nextUntil() 對稱的祖先版本,用法與官方說明一致,詳見:
https://api.jquery.com/parentsUntil/
以上就是 1.4 新增方法的整理,稍後會把所有 demo 打包放出。