DIV CSS 佈局教程網

jQuery 1.4 新特性(三):七個新增方法實戰解析
編輯:JQuery特效代碼     

.clearQueue():清空尚未執行的佇列

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(),動畫雖然停了,但後續排隊的步驟還是會接著播放。

.contains():判斷 DOM 包含關係

接受兩個 DOM 元素作為參數(注意不是 jQuery 物件):

jQuery.contains(document.documentElement, document.body);   // true
jQuery.contains(document.body, document.documentElement);   // false

.delay():為佇列插入延遲

兩個參數:第一個是延遲毫秒數,第二個是佇列名稱(可選)。

<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 硬寫。

.detach():移除元素但保留資料

作用近似 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() 存在的意義。

.has():篩選含指定後代的元素

接受選擇器或 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():判斷物件是否為空

jQuery.isEmptyObject({});                 // true
jQuery.isEmptyObject({ foo: "bar" });     // false

jQuery.isPlainObject():判斷是否為純物件

jQuery.isPlainObject({});       // true
jQuery.isPlainObject("test");   // false

.nextUntil([selector]):取到下一個符合選擇器為止

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(),方向相反,這裡不再示範。

jQuery.noop():回傳一個空函式

寫插件時拿來當預設回呼很好用,可以避免到處寫 if (typeof callback == "function") 的判斷。

.parentsUntil([selector])

與 nextUntil() 對稱的祖先版本,用法與官方說明一致,詳見:
https://api.jquery.com/parentsUntil/

以上就是 1.4 新增方法的整理,稍後會把所有 demo 打包放出。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved