「點一下展開、再點一下收合」是網頁上最常被使用的互動之一,FAQ、篩選面板、側邊抽屜都離不開它。jQuery 的 slideToggle() 把這件事壓縮成一行。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>slideToggle 下拉收合範例</title>
<style type="text/css">
body { margin:0 auto; padding:0; width:570px; font:75%/120% Arial, Helvetica, sans-serif; }
a:focus { outline:none; }
#panel { background:#69C7F7; height:200px; display:none; }
.slide { margin:0; padding:0; border-top:solid 4px #F27613; }
.btn-slide { background:#F27613 url(mytest/jQuery/20121225165932118.gif) no-repeat right -50px;
text-align:center; width:144px; height:31px; padding:10px 10px 0 0; margin:0 auto;
display:block; font:bold 120%/100% Arial, Helvetica, sans-serif;
color:#fff; text-decoration:none; }
.active { background-position:right 12px; }
</style>
<script type="text/javascript" src="jquery-1.8.3.js"></script>
<script type="text/javascript">
$(document).ready(function () {
$(".btn-slide").click(function () {
$("#panel").slideToggle("slow");
$(this).toggleClass("active");
return false;
});
});
</script>
</head>
<body>
<div id="panel"></div>
<p class="slide">
<a href="javascript:;" class="btn-slide active">點擊查看效果</a>
</p>
</body>
</html>
兩個方法搭出完整效果:slideToggle("slow") 負責面板的垂直展開與收合,toggleClass("active") 負責切換按鈕的背景位置,讓箭頭圖示在「展開」與「收合」兩種狀態間翻轉。整段互動邏輯不到三行,這正是許多人當年選擇 jQuery 的原因。
"slow"(600ms)、"fast"(200ms)或直接給毫秒數。若追求更細膩的手感,改用 CSS transition 搭配 class 切換會比 jQuery 逐格運算更順,也不佔用主執行緒。.stop(true, true) 可清掉佇列並立刻跳到最終狀態:$("#panel").stop(true, true).slideToggle("slow");。display:none,按鈕卻帶著 active class,兩者語意相反。實作時請讓二者對齊,否則箭頭方向會騙人。<a> 或 <button> 觸發時,記得讓鍵盤可操作,並在展開時更新 aria-expanded,螢幕閱讀器才知道狀態改變了。若使用 Bootstrap 或 Tailwind 這類框架,內建的 Collapse 元件已處理好這些細節,除非有特殊樣式需求,否則不必自己重造。