DIV CSS 佈局教程網

jQuery 手風琴效果實作:Accordion 搭配 Sortable 讓面板可拖曳排序
編輯:JQuery特效代碼     

手風琴(Accordion)是收納大量分類內容的經典元件:一次只展開一個區塊,省版面又保持條理。jQuery UI 提供的 Accordion 插件幾行就能搞定,再疊上 Sortable 還能讓使用者拖曳調整面板順序。

範例程式碼

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>手風琴</title>

<script type="text/javascript" language="javascript" src="jquery-1.7.1.min.js">
</script>
<script type="text/javascript" language="javascript" src="jquery-ui-1.8.18.custom.min.js">
</script>
<link rel="stylesheet" href="ui-lightness/jquery-ui-1.8.18.custom.css"/>
<script type="text/javascript" language="javascript">
$(function(){
    $("#accordion").accordion(
    {
        header: "h3",
        event: "mouseover",
        icons: {
            header: "ui-icon-carat-2-e-w"
        },
    }
    ).sortable({
        axis: "Y"   // 拖動效果:上下拖動,預設為左右
    });
})
</script>
</head>
<body>
<div id="accordion" style="width:600px; height:600px; border:1px #F00 solid">
   <div>
     <h3><a href="#">first</a></h3>
     <div>Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet.</div>
   </div>
  <div>
  <h3><a href="#">second</a></h3>
  <div>Phasellus mattis tincidunt nibh.</div>
  </div>
  <div>
  <h3><a href="#">third</a></h3>
  <div>悠悠</div>
  </div>
</div>
</body>
</html>

結構與設定說明

HTML 結構是固定的三層:最外層容器,中間每個面板一個 div,面板內必須有「標題元素 + 內容元素」兩塊。範例用 h3 當標題、a 包住文字(為了讓鍵盤可以 focus),內容則是緊接在後的 div。header: "h3" 就是告訴插件標題長在哪裡。

event: "mouseover" 把切換方式從預設的 click 改成滑過即展開。這在選單式導覽上很順手,但在觸控裝置上完全無效——手機沒有 hover,因此跨裝置專案請保留預設的 click。

icons.header 指定標題旁的狀態圖示。這裡用的 ui-icon-carat-2-e-w 是左右雙箭頭,暗示「可拖曳排序」;一般展開收合通常用 ui-icon-triangle-1-e(收起)與 ui-icon-triangle-1-s(展開),插件會自動依狀態切換。

串接 sortable 並指定 axis: "Y" 是這個範例的變化重點。手風琴是垂直排列的,因此限制只能上下拖動;Sortable 預設沒有方向限制。兩者串接後,使用者就能拖曳標題列來調整面板順序。

幾個實務上的考量

高度設定。範例給容器寫死了 600px,這是因為 Accordion 預設會依內容最高的 panel 決定高度,避免展開時版面跳動。若希望高度隨內容伸縮,可加上 heightStyle: "content"(1.9 之後的寫法)或舊版的 autoHeight: false。

可排序但記得要存。Sortable 只改變了畫面上的順序,重新整理後會回到原樣。若要記住使用者的排序,需監聽 Sortable 的 update 事件,把新的順序以 Ajax 回傳伺服器保存。

只展開一個的行為。預設一次只有一個面板展開,若要允許全部收合,可設定 collapsible: true;若要預設全部展開,用 active: false。

最後提醒,範例基於 jQuery UI 1.8,其中 autoHeight、icons.header 等選項在 1.9 之後更名為 heightStyle、icons.headerSelected。若專案使用較新版本,建議對照官方 changelog 調整,否則設定會靜默失效。

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