FAQ、產品規格、條款說明——這類內容的共同點是「段落多、但一次只需要看一段」。手風琴(Accordion)正是為此而生:同一時間只展開一個區塊,其餘收合成標題列,資訊密度高又不顯得雜亂。
jQuery UI 把這個互動模式包裝成一行就能呼叫的 accordion(),本文說明它的結構要求、初始化方式與常用設定。
實際效果可見手風琴菜單示範。
Accordion 對 HTML 的要求非常樸素:一個容器,裡面「標題 + 內容面板」交替排列。標題建議用 h3,面板則是一個普通 div:
#accordion-keleyi-com { width: 500px; }
容器內部依序放入四組 h3 與 div,每個 div 裡裝一段文字或一個清單。標題文字就是使用者看到的可點擊列,因此寫得清楚與否,直接決定這個元件好不好用。
需要三個檔案:jQuery UI 的樣式表、jQuery 本體、以及 jQuery UI 腳本。範例搭配 jQuery 1.10.2 與 jQuery UI 1.10.3:
keleyi/pmedia/jquery/ui/1.10.3/css/smoothness/jquery-ui.min.css
keleyi/pmedia/jquery/jquery-1.10.2.min.js
keleyi/pmedia/jquery/ui/1.10.3/js/jquery-ui-1.10.3.min.js
初始化只要一行:
$(function () {
$("#accordion-keleyi-com").accordion();
});
active:指定一開始展開哪一頁,從 0 開始計數;設為 false 則全部收合。collapsible:設為 true 後,再點一次已展開的標題可以把它收起,形成「全收合」狀態。event:預設是 click,改成 mouseover 就能做成滑過即展開。若採用 hover,務必搭配 collapsible,否則游標路過時會一直切換。heightStyle:auto 讓所有面板等高(預設)、content 依內容自適應、fill 撐滿父容器。內容長度差異大時建議用 content。icons:可自訂展開與收合狀態的圖示;不想要圖示就設為 false。animate:控制展開動畫,設 false 可關閉動畫,對效能或偏好減少動態的使用者更友善。手風琴適合「彼此對等、可獨立閱讀」的內容,例如常見問答、多組規格、章節摘要。它不適合有先後順序、需要同時對照的資訊——那類內容用一般的分節標題反而更合適。
無障礙方面,jQuery UI 的 accordion 已內建適當的 ARIA 屬性與鍵盤操作(方向鍵在標題間移動、空白鍵切換),只要照標準結構撰寫標題與面板,就能直接受益。真正需要留意的是標題層級不要跳階,並為面板內容提供有意義的-labelledby 關聯。