DIV CSS 佈局教程網

Bootstrap 折疊(Collapse)插件完整教學:從手風琴面板到互動組件
編輯:關於JavaScript     

Bootstrap 由 Twitter 團隊打造,長年是前端開發者最愛用的框架之一。它以 HTML、CSS 與 JavaScript 為基礎,語法簡潔、擴展靈活,能大幅加快網頁的開發節奏。本文將帶你完整認識 Bootstrap 的折疊(Collapse)插件,透過實作範例一步步掌握它的用法。

折疊插件能為你帶來什麼

折疊(Collapse)插件的核心能力,就是讓頁面上的區塊可以隨意展開與收起。無論你想製作可折疊的側邊選單,還是層次分明的內容面板,它都能提供豐富的展現方式。

使用前需要引入哪些檔案

如果你只想單獨使用折疊功能,需要引入 collapse.js,同時也要載入 Bootstrap 的過渡(Transition)插件。當然,最省事的做法是直接引入完整的 bootstrap.js,或是壓縮後的 bootstrap.min.js。

實作一:建立手風琴式的折疊面板

手風琴面板是折疊插件最經典的應用場景,一次只展開一個區塊,點擊標題即可切換:

 <!DOCTYPE html> <html> <head> <title>Bootstrap 實例 - 折疊面板</title> <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet"> <script src="/scripts/jquery.min.js"></script> <script src="/bootstrap/js/bootstrap.min.js"></script> </head> <body> <div class="panel-group" id="accordion"> <div class="panel panel-default"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseOne"> 點擊我進行展開,再次點擊我進行折疊。第 1 部分 </a> </h4> </div> <div id="collapseOne" class="panel-collapse collapse in"> <div class="panel-body"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div> </div> </div> <div class="panel panel-default"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseTwo"> 點擊我進行展開,再次點擊我進行折疊。第 2 部分 </a> </h4> </div> <div id="collapseTwo" class="panel-collapse collapse"> <div class="panel-body"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div> </div> </div> <div class="panel panel-default"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseThree"> 點擊我進行展開,再次點擊我進行折疊。第 3 部分 </a> </h4> </div> <div id="collapseThree" class="panel-collapse collapse"> <div class="panel-body"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div> </div> </div> </div> </body> </html>

完成後的顯示效果如下:

幾個關鍵屬性的作用如下:

data-toggle="collapse":加在你想觸發展開或收起的連結上。

href 或 data-target:指向父組件,其值為子組件的 id。

data-parent:把折疊面板(accordion)的 id 加到連結上,用來實現「同時間只展開一個」的分組管理。

實作二:簡單的可折疊組件

如果不需要手風琴那種互斥效果,也能做出單純的折疊組件:

 <!DOCTYPE html> <html> <head> <title>Bootstrap 實例 - 簡單的可折疊組件</title> <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet"> <script src="/scripts/jquery.min.js"></script> <script src="/bootstrap/js/bootstrap.min.js"></script> </head> <body> <button type="button" class="btn btn-primary" data-toggle="collapse" data-target="#demo"> 簡單的可折疊組件 </button> <div id="demo" class="collapse in"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div> </body> </html>

效果如下:

從範例可以看到,這次我們並沒有加上 data-parent 屬性,因此每個組件彼此獨立、互不干擾。

用法解析

折疊插件會透過一組 class 來控制元素的伸縮狀態:

使用方式主要有兩種:

透過 data 屬性:只要為元素加上 data-toggle="collapse" 與 data-target,就能自動綁定折疊控制。data-target 接受 CSS 選擇器,並對其套用折疊效果。別忘了為可折疊元素加上 .collapse class;若希望它預設展開,再額外加上 .in。若想達到分組互斥效果,則再加上 data-parent="#selector"。

透過 JavaScript:也可以直接呼叫 collapse 方法來啟用:

 $('.collapse').collapse()

可選參數(Options)

部分選項可以透過 data 屬性或 JavaScript 傳入,下表列出常用選項:

常用方法(Methods)

折疊插件提供了幾個實用的方法,方便你在程式碼中精準控制:

下面的範例示範了這些方法的實際用法:

 <!DOCTYPE html> <html> <head> <title>Bootstrap 實例 - 折疊(Collapse)插件方法</title> <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet"> <script src="/scripts/jquery.min.js"></script> <script src="/bootstrap/js/bootstrap.min.js"></script> </head> <body> <div class="panel-group" id="accordion"> <div class="panel panel-default"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseOne"> 點擊我進行展開,再次點擊我進行折疊。第 1 部分--hide 方法 </a> </h4> </div> <div id="collapseOne" class="panel-collapse collapse in"> <div class="panel-body"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div> </div> </div> <div class="panel panel-success"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseTwo"> 點擊我進行展開,再次點擊我進行折疊。第 2 部分--show 方法 </a> </h4> </div> <div id="collapseTwo" class="panel-collapse collapse"> <div class="panel-body"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div> </div> </div> <div class="panel panel-info"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseThree"> 點擊我進行展開,再次點擊我進行折疊。第 3 部分--toggle 方法 </a> </h4> </div> <div id="collapseThree" class="panel-collapse collapse"> <div class="panel-body"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div> </div> </div> <div class="panel panel-warning"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseFour"> 點擊我進行展開,再次點擊我進行折疊。第 4 部分--options 方法 </a> </h4> </div> <div id="collapseFour" class="panel-collapse collapse"> <div class="panel-body"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div> </div> </div> </div> <script type="text/javascript"> $(function () { $('#collapseFour').collapse({ toggle: false })}); $(function () { $('#collapseTwo').collapse('show')}); $(function () { $('#collapseThree').collapse('toggle')}); $(function () { $('#collapseOne').collapse('hide')}); </script> </body> </html> 

執行結果如下:

事件(Events)

折疊插件還提供了幾個事件,可以作為函數中的鉤子使用,讓你在展開或收起的過程中觸發自訂行為:

下面這個範例示範了如何監聽事件:

 <!DOCTYPE html> <html> <head> <title>Bootstrap 實例 - 折疊(Collapse)插件事件</title> <link href="/bootstrap/css/bootstrap.min.css" rel="stylesheet"> <script src="/scripts/jquery.min.js"></script> <script src="/bootstrap/js/bootstrap.min.js"></script> </head> <body> <div class="panel-group" id="accordion"> <div class="panel panel-info"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseexample"> 點擊我進行展開,再次點擊我進行折疊。--shown 事件 </a> </h4> </div> <div id="collapseexample" class="panel-collapse collapse"> <div class="panel-body"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div> </div> </div> </div> <script type="text/javascript"> $(function () { $('#collapseexample').on('show.bs.collapse', function () { alert('嘿,當您展開時會提示本警告');}) }); </script> </body> </html>

效果如下:

以上就是 Bootstrap 折疊(Collapse)插件的完整用法與實作範例,希望能幫助你把這個實用組件應用到自己的專案裡。

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