相關原始碼分布在三個檔案:_navs.scss 負責導覽模組本身,Mixins/_nav-divider.scss 負責分隔線,Mixins/_nav-vertical-align.scss 負責垂直對齊。
讀完可以歸納出幾個重點:
1. nav 純粹靠 CSS 修飾樣式,對 JavaScript 毫無依賴。這意味著只要套 class 就能用,不必擔心 JS 順序問題。
2. 導覽模組可以容納下拉選單,但下拉的展開行為仍要靠 dropdown 的 JS。
3. 它提供了水準、垂直、水準平均分配(以 table-cell 實作,4.0 已移除)、tabs、膠囊等多種變體。
4. nav-divider 用一像素高度畫出分隔線。
5. nav-stacked 負責堆疊成垂直排列。
6. 搭配 tab-content 作為容器、tab-pane 作為各頁內容,就能擴充成完整的分頁介面。
7. 有個容易忽略的細節:nav-tabs 底下的 dropdown 做了一像素的向上收縮。原因是 nav-tabs 自帶一條底線,若不上移,選單與底線之間就會露出一道白色縫隙。
// Specific dropdowns .nav-tabs .dropdown-menu { // make dropdown border overlap tab border margin-top: -1px; // Remove the top rounded corners here since there is a hard edge above the menu @include border-top-radius(0); }順帶一提,這裡同時移除了上方的圓角,因為緊貼著的底線已經形成硬邊,保留圓角反而視覺突兀。
相關檔案是 Mixins/_component-animations.scss(樣式與過渡)與 Javascripts/bootstrap/collapse.js(行為)。
1. 用 data() 收集所有 data-* 設定
外掛初始化時會把元素上的 data 屬性整批讀進 options,這也是為什麼 Bootstrap 元件能用純 HTML 屬性驅動。
2. parent 選項:一控多
指定 parent 之後,展開某一個面板時會自動收起同一父層下的其他面板,也就是手風琴效果:
return $(this.options.parent) .find('[data-toggle="collapse"][data-parent="' + this.options.parent + '"]') .each($.proxy(function (i, element) { var $element = $(element); this.addAriaAndCollapsedClass(getTargetFromTrigger($element), $element); }, this)) .end();3. 選單查找的隱含前提
這段程式碼用 find 在 parent 底下找子列表,因此實際使用時,各面板通常都得放在 .panel 之內,否則找不到目標。
4. jQuery 的 end()end() 會結束當前的篩選鏈,把匹配集合還原到鏈的起點。例如 $("p").find('.bak').find('span').end() 會退回到 $("p").find('.bak') 的狀態。寫巢狀查詢時,這讓鏈式寫法得以 reuse。
5. scrollHeight 的角色
展開時需要知道目標元素的「真實高度」,而 scrollHeight 正是包含不可見部分在內的完整尺寸。過渡結束後,Bootstrap 會把 height 清空,交還給內容自行決定:
var scrollSize = $.camelCase(['scroll', dimension].join('-')); this.$element .one('bsTransitionEnd', $.proxy(complete, this)) .emulateTransitionEnd(Collapse.TRANSITION_DURATION)[dimension](this.$element[0][scrollSize]);這裡的 emulateTransitionEnd 是個實用的保險:它會設定一個逾時,萬一 CSS transition 事件沒有觸發(例如元素被 display:none 或瀏覽器不支援),仍能在預估時間後強制收尾,避免面板卡在展開一半的狀態。
6. 兩種角色要分清楚
處理的元素其實有兩類:要展開或隱藏的本體($element),以及觸發動作的按鈕($trigger)。後者需要維護 aria-expanded 與 collapsed class,讓無障礙狀態與視覺一致。
7. 隱藏前先量實際高度
this.$element[dimension](this.$element[dimension]())[0].offsetHeight;
這行先把目前高度寫死,再讀一次 offsetHeight 強制瀏覽器重排(reflow)。少了這步,動畫不會播放,元素會直接消失——這是 CSS transition 的已知特性,瀏覽器需要一個「起始狀態已被計算過」的參照。
8. hide 通常由 show 觸發
if (actives && actives.length) { Plugin.call(actives, 'hide'); activesData || actives.data('bs.collapse', null); }show 執行前會先檢查同一 parent 下是否有已展開的項目,有的話先呼叫 hide。把「收起其他」的責任放在 show 裡,是為了讓 hide 保持單純——直接呼叫 hide 時不該有副作用。