手風琴是「一次只顯示一塊內容」的經典互動。這個例子示範如何一步步把它做成外掛,並用 delegate 處理事件、用 options 指定預設展開哪一項。
<div id="pane-container">
<div class="pane">
<h1>first pane</h1>
<p>this script should allow only one pane to be visible at a time.</p>
</div>
<div class="pane">
<h1>second pane</h1>
<p>this script should allow only one pane to be visible at a time.</p>
</div>
<div class="pane">
<h1>third pane</h1>
<p>this script should allow only one pane to be visible at a time.</p>
</div>
</div>
<style type="text/css">
#pane-container { margin: 0; padding: 0; width: 200px; }
.pane h1 {
padding: 5px;
cursor: pointer; /* 提示這裡可以點 */
position: relative;
background-color: #4c4c4c;
color: #fff;
font-weight: normal;
font-size: 20px;
margin: 0px;
}
.pane p { padding: 10px; margin: 0; background-color: #e4e4e4; }
</style>
結構刻意簡單:每個 .pane 就是一個 h1 標題加一段 p 內容。h1 永遠可見,p 才是要收合的部分。
(function ($) {
$.fn.accordtion = function () {
return this.each(function () {
$(this).find('p').hide();
});
}
})(jQuery);
$(document).ready(function () {
$('#pane-container').accordtion();
});
這裡用 delegate 而非直接 click。差別在於 delegate 把事件綁在容器上、由容器判斷來源,因此之後動態新增的 pane 也能自動生效,不必重新綁定。
// 對 h1 設定 click 事件
self.delegate('h1', 'click', function () {
$(this).next('p').slideToggle(600) // 自己的內容展開/收起
.parent().siblings().children('p').slideUp(600); // 其他內容一律收起
});
next('p') 找到同層的下一個 p,parent().siblings().children('p') 則往上一層取得兄弟 pane,再往下找它們的 p。這條鏈式寫法是 jQuery traversing 的典型用法,比反覆 find 整個文件有效率得多。
// 讓第 visibleByDefault 個 pane 的內容顯示出來
self.children(':eq(' + options.visibleByDefault + ')')
.children('p')
.show();
加上這段之後,外掛的完整骨架大致如下:
(function ($) {
$.fn.accordtion = function (options) {
var defaults = { visibleByDefault: 0 };
var options = $.extend(defaults, options);
return this.each(function () {
var self = $(this);
self.find('p').hide();
self.delegate('h1', 'click', function () {
$(this).next('p').slideToggle(600)
.parent().siblings().children('p').slideUp(600);
});
self.children(':eq(' + options.visibleByDefault + ')').children('p').show();
});
};
})(jQuery);
這個版本每次點擊都做 slideToggle,因此點同一個標題會把它收起来變成全收狀態。若希望「一定要有一項展開」,可以在切換前先判斷目標是否已展開,是的話就跳過。另外,無障礙方面建議在 h1 上補 tabindex 與 aria-expanded,讓鍵盤與螢幕閱讀器也能理解狀態變化——這是原型階段的 jQuery 範例常忽略、但正式專案必須補上的一塊。
完整程式可下載 jQuery.plugin.accordtion 的 demo 參考。