Bootstrap 的 Collapse 元件可以讓內容按需展開與收合,而且大多數情況下完全不必自己寫 JavaScript。以下整理它的用法。
頁面需要引入兩個腳本:jquery.js 與 bootstrap-collapse.js,在文件裡都能於 docs/assets/js 目錄下找到。樣式檔 bootstrap.css 當然也要載入。
這個寫法完全不需要撰寫 JavaScript,靠 data 屬性驅動:
<!DOCTYPE html> <html> <head> <meta charset="utf-8" /> <title>collapsible example</title> <link href="../twitter-bootstrap/twitter-bootstrap-v2/docs/assets/css/bootstrap.css" rel="stylesheet" type="text/css" /> </head> <body> <div class="container-fluid"> <div class="accordion" id="accordion2"> <div class="accordion-group"> <div class="accordion-heading"> <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion2" href="#collapseOne"> Click me to exapand. Click me again to collapse. Part I. </a> </div> <div id="collapseOne" class="accordion-body collapse" style="height: 0px; "> <div class="accordion-inner"> Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. </div> </div> </div> <div class="accordion-group"> <div class="accordion-heading"> <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion2" href="#collapseTwo"> Click me to exapand. Click me again to collapse. Part II. </a> </div> <div id="collapseTwo" class="accordion-body collapse"> <div class="accordion-inner"> Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. </div> </div> </div> <div class="accordion-group"> <div class="accordion-heading"> <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion2" href="#collapseThree"> Click me to exapand. Click me again to collapse. Part III. </a> </div> <div id="collapseThree" class="accordion-body collapse"> <div class="accordion-inner"> Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. </div> </div> </div> </div> </div> <script type="text/javascript" src="/twitter-bootstrap/twitter-bootstrap-v2/docs/assets/js/jquery.js"></script> <script type="text/javascript" src="/twitter-bootstrap/twitter-bootstrap-v2/docs/assets/js/bootstrap-collapse.js"></script> </body> </html>
data-toggle="collapse":加在你要點擊的連結上,宣告它是觸發收合的開關。
href 或 data-target:加在同一個元素上,值指向要收合的子元件 id,兩者擇一即可。
data-parent:值填最外層容器的 id。加上它之後,展開某一項會自動收起其他項,這就是手風琴行為。如果你只想要各自獨立、互不干擾的收合元件,把這個屬性拿掉就行。
<!DOCTYPE html> <html> <head> <meta charset="utf-8" /> <title>collapsible via JavaScript example</title> <link href="/twitter-bootstrap/twitter-bootstrap-v2/docs/assets/css/bootstrap.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="myCollapsibleExample"><a href="#demo" data-toggle="collapse">Click me to expand and click me again to collapse.</a></div> <div id="demo" class="collapse"> Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehe. </div> <script type="text/javascript" src="/twitter-bootstrap/twitter-bootstrap-v2/docs/assets/js/jquery.js"></script> <script type="text/javascript" src="/twitter-bootstrap/twitter-bootstrap-v2/docs/assets/js/bootstrap-collapse.js"></script> </body> </html>
如果收合行為需要由程式邏輯控制,直接呼叫外掛方法即可:
$(".collapse").collapse()
選項
parent:類型為 Selector,預設 false。設定後,父元素顯示時,其下所有可收合元素都會被關閉。
toggle:類型為 Boolean,預設 true。呼叫時切換所有可收合元素。
方法
.collapse(options):以選項物件啟動收合行為。
.collapse('toggle'):切換顯示/隱藏。
.collapse('show'):展開。
.collapse('hide'):收合。
事件
show:show 方法被呼叫後立刻觸發。
shown:元素已經顯示、CSS 過渡也跑完之後觸發。
hide:hide 方法被呼叫後立刻觸發。
hidden:元素已經隱藏、過渡結束後觸發。
實務上常見的用法是監聽 shown 而非 show,因為高度計算、圖片載入或第三方 widget 初始化都得等過渡結束才抓得到正確尺寸。
以上就是 Bootstrap 折疊元件的核心用法,掌握 data 屬性與事件時機,就足以應付大部分 FAQ、側欄選單與手風琴的需求。