DIV CSS 佈局教程網

Bootstrap 折疊(Collapse)插件:手風琴、面板與事件
編輯:關於JavaScript     

折疊插件讓頁面中的區塊可以收合與展開。無論要做折疊式導覽選單、FAQ 列表還是內容面板,它都能勝任。若只想載入這個功能,引入 collapse.js 即可,或直接載入 bootstrap.js/bootstrap.min.js。

一、相關的 class

Collapse 插件用來處理伸縮效果的 class 只有幾個:

二、兩種使用方式

透過 data 屬性

在觸發元素上加 data-toggle="collapse" 與 data-target,插件就會自動把控制權指派給目標的可折疊元素。data-target 接受一個 CSS 選擇器。

兩個必備條件:目標元素必須加上 .collapse 類;若希望它預設是展開的,再額外加上 .in。

若要做成手風琴那種「展開一個就自動收起其他」的分組管理,加上 data-parent="#selector",指向外層的群組容器。

透過 JavaScript

$('.collapse').collapse()

三、基本範例

<button class="btn btn-primary" data-toggle="collapse" data-target="#content">
  Bootstrap
</button>
<div class="collapse" id="content">
  <div class="well">
    Bootstrap 是 Twitter 推出的一個用於前端開發的開源工具包,由 Mark Otto
    與 Jacob Thornton 合作開發,是一套 CSS/HTML 框架。
  </div>
</div>

四、手風琴效果

用 .panel-group 包住多個面板,並讓每個觸發連結都指向同一個 data-parent:

<div class="panel-group" id="accordion">
  <div class="panel panel-default">
    <div class="panel-heading">
      <h4 class="panel-title">
        <a href="#collapseOne" data-toggle="collapse" data-parent="#accordion">
          點擊展開,再點擊折疊 —— 第一部分
        </a>
      </h4>
    </div>
    <div id="collapseOne" class="panel-collapse collapse in">
      <div class="panel-body">這裡是第一部分。</div>
    </div>
  </div>

  <div class="panel panel-default">
    <div class="panel-heading">
      <h4 class="panel-title">
        <a href="#collapseTwo" data-toggle="collapse" data-parent="#accordion">
          點擊展開,再點擊折疊 —— 第二部分
        </a>
      </h4>
    </div>
    <div id="collapseTwo" class="panel-collapse collapse">
      <div class="panel-body">這裡是第二部分。</div>
    </div>
  </div>

  <div class="panel panel-default">
    <div class="panel-heading">
      <h4 class="panel-title">
        <a href="#collapseThree" data-toggle="collapse" data-parent="#accordion">
          點擊展開,再點擊折疊 —— 第三部分
        </a>
      </h4>
    </div>
    <div id="collapseThree" class="panel-collapse collapse">
      <div class="panel-body">這裡是第三部分。</div>
    </div>
  </div>
</div>

注意第一個面板的內容 div 上多了 in——這就是「預設展開」的開關。

五、參數、方法與事件

手風琴的 JavaScript 寫法

$('#collapseOne, #collapseTwo, #collapseThree').collapse({
  parent: '#accordion',
  toggle: false
});

手動觸發

$('button').on('click', function () {
  $('#collapseOne').collapse({ toggle: true });
});

三個方法

$('#collapseOne').collapse('hide');    // 收起
$('#collapseTwo').collapse('show');    // 展開
$('#collapseOne').collapse('toggle');  // 反轉狀態

四個事件

$('#collapseOne').on('show.bs.collapse', function () {
  alert('呼叫 show 方法時觸發');
});

這裡有個實務上很常被忽略的細節:折疊動畫是高度過渡,元素在動畫期間的高度是動態的。因此若你的折疊內容裡包含圖片、地圖或需要重新計算尺寸的元件(例如圖表),應該在 shown.bs.collapse 中觸發其 resize/redraw,而不是在 show 裡——因為此時元素高度還是 0,計算結果會是錯的。

另外,由於 Collapse 預設使用 CSS transition,若使用者系統設定了「減少動態效果」偏好,建議搭配 prefers-reduced-motion media query 關閉動畫,這對前庭功能敏感的使用者很重要。

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