DIV CSS 佈局教程網

jQuery 外掛製作:手風琴 Panel 的收合效果
編輯:JQuery特效代碼     

手風琴是「一次只顯示一塊內容」的經典互動。這個例子示範如何一步步把它做成外掛,並用 delegate 處理事件、用 options 指定預設展開哪一項。

HTML 與 CSS

<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 整個文件有效率得多。

第三步:加上 options,指定預設展開項

// 讓第 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 參考。

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