「點標題收合清單」這個需求,用 jQuery 至少有四種寫法。把它們放在一起對照,正好能釐清 css、hide/show、toggle 三者之間的關係與適用時機。
<div class="topicList">
<h3><span>學習天地</span></h3>
<ul>
<li>1111111111</li>
<li>2222222222</li>
<li>333333333</li>
<li>4444444444</li>
<li>5555555555</li>
<li>6666666666</li>
</ul>
</div>
$(function () {
$(".topicList h3").click(function () {
var UL = $(this).next("ul");
if (UL.css("display") == "none") {
UL.css("display", "block");
} else {
UL.css("display", "none");
}
});
});
最原始的想法:自己判斷狀態、自己切換。缺點很明顯——沒有動畫,而且 display 該設 block 還是原本的值(可能是 flex、grid、inline-block)得自己記住,寫死 block 很容易破壞原本的排版。
$(function () {
$(".topicList h3").toggle(function () {
$(this).next("ul").hide(1000);
}, function () {
$(this).next("ul").show(1000);
});
});
hide(1000)/show(1000) 會附帶滑動動畫,比第一種柔和。但要注意 toggle(函式, 函式) 這種雙函式用法已在 jQuery 1.9 移除,新專案請不要用。
$(function () {
$(".topicList h3").toggle(function () {
$(this).next("ul").css("display", "none");
}, function () {
$(this).next("ul").css("display", "block");
});
});
這一版和第一種本質相同,只是把 if 判斷換成了雙函式 toggle。同樣有 1.9 相容性問題,也同樣有寫死 block 的毛病。
$(function () {
$(".topicList h3").toggle(topicHandler, topicHandler);
function topicHandler() {
// fadeIn、show、slideDown 可以完成顯示
// fadeOut、hide、slideUp 可以完成隱藏
// 所以可以透過各自的 toggle 來完成兩者輪換
$(this).next("ul").toggle(1000);
}
});
把同一個函式傳兩次,等於「每次點擊都做同一件事」——而那件事就是 toggle 本身。繞了一圈,其實就是在示範 .toggle(duration) 的用法。
// 最終答案,一行
$(".topicList h3").on("click", function () {
$(this).next("ul").slideToggle(300);
});
slideToggle() 自動判斷當前狀態、動畫平順、也不會搞壞原本的 display 值,是這個需求的正解。若要淡入淡出則換成 fadeToggle()。
這個名字在 jQuery 裡被重複使用,容易搞混:
.toggle(duration):切換可見性(本篇主題)。.toggle(fn1, fn2):在數個 handler 之間輪流觸發(已於 1.9 移除,1.9 之前另有 .toggle(bool) 可強制顯示/隱藏)。.toggleClass(name):切換 class,跟顯示無關,純粹是樣式切換。另外提醒:slideToggle 在元素有 padding 時滑動會略顯突兀,把內距移到子元素即可解決;多個面板並存時,記得用 .stop(true, true) 避免連續點擊造成動畫堆疊。