項目中有一個實時監控模塊:左側菜單欄列出所有設備(數據從數據庫動態讀取,用 dtree.js 渲染),右側是顯示監控畫面的 iframe。功能本身不複雜,但上線前發現一個問題——部分設備名很長,超出了菜單欄 div 的寬度,必須靠滾動條才能看全。
給 div 加上 overflow-x: auto; overflow-y: auto; 確實能自動生成滾動條,問題是瀏覽器自帶的樣式實在難看,與整體界面風格格格不入。於是重點變成了:如何改滾動條的樣式。
早期主流做法是使用一組瀏覽器專有屬性,如 ::-webkit-scrollbar 及其配套的 ::-webkit-scrollbar-button、::-webkit-scrollbar-thumb、::-webkit-scrollbar-track 等偽元素,共七八個選擇器,可以分別控制箭頭、滑塊、軌道、角部等部件的尺寸與配色。IE 則有 scrollbar-face-color、scrollbar-track-color 一類專屬屬性。
這種方案的優點是零依賴、性能好;缺點是各瀏覽器屬性差異大,需要分別書寫,且 Firefox 長期缺乏支持。
不用 div 自帶的滾動條,完全用 DOM 模擬,這樣想要什麼效果就能做出什麼效果。網上現成的實現基本都是豎向的,橫向的很少見,於是只能借鑑豎向版本自己補一個橫向的。
實現思路是:目標 div 內部嵌套三層——顯示內容的 div_content、模擬豎向滾動條的 div_H、模擬橫向滾動條的 div_W,整體佈局與原生滾動條的位置保持一致。而 div_H 和 div_W 各自又包含三個子 div:左右(或上下)兩個箭頭加中間的滑塊。
if ($(_self).children(".jscroll-c").height() == null) {
// 添加內容框
$(_self).wrapInner(
"<div class='jscroll-c' style='top:0px;z-index:9999;zoom:1;position:relative;'></div>"
);
// 添加豎向滾動條:上箭頭 + 滑塊 + 下箭頭
$(_self).append(
"<div class='jscroll-e' unselectable='on'
style='height:97.5%;top:0px;right:0;position:absolute;overflow:hidden;z-index:10000;'>
<div class='jscroll-u' style='position:absolute;top:0px;width:100%;right:0;background:blue;overflow:hidden'></div>
<div class='jscroll-h' unselectable='on'
style='background:green;position:absolute;left:0;border:1px solid'></div>
<div class='jscroll-d' style='position:absolute;bottom:0px;width:100%;left:0;background:blue;overflow:hidden'></div>
</div>"
);
// 添加橫向滾動條:左箭頭 + 滑塊 + 右箭頭
$(_self).append(
"<div class='jscroll-s' unselectable='on'
style='width:180px;bottom:0px;left:0;position:absolute;overflow:hidden;z-index:10000;'>
<div class='jscroll-l' style='position:absolute;bottom:0px;height:100%;left:0;background:blue;overflow:hidden'></div>
<div class='jscroll-g' unselectable='on'
style='height:100%;background:green;position:absolute;left:0;border:1px solid'></div>
<div class='jscroll-r' style='position:absolute;bottom:0px;height:100%;right:0;background:blue;overflow:hidden'></div>
</div>"
);
}
結構搭好之後,剩下的就是一些常規判斷:內容尺寸是否超出容器範圍、超出的話顯示對應滾動條,以及為箭頭和滑塊綁定 mousedown、mousemove、mouseup 事件實現拖動。這些細節代碼量不小,此處不展開。
自定義滾動條的自由度確實高,但代價需要提前想清楚:拖動邏輯涉及大量坐標換算與邊界判斷,還要處理滾輪事件、觸屏手勢、內容動態變化後的尺寸重算,以及鍵盤無障礙操作。這些邊角往往比主流程更耗時,也更容易出 bug。
好消息是今天不必自己造輪子。CSS 標準已經提供了 scrollbar-width 與 scrollbar-color 兩個屬性,Firefox 長期支持,Chrome、Edge 也已跟進,能在不引入任何 JS 的前提下調整滾動條的粗細與配色,覆蓋大多數「只是嫌難看」的需求。
如果設計要求高度定制(自繪滑塊、貼合品牌視覺),建議使用成熟庫而非自研,例如 OverlayScrollbars、simplebar 等,它們已經處理好了觸屏、滾輪、可訪問性和內容變化監聽等邊角問題。自研方案在教學和極簡場景下仍有價值,但投入生產前請把維護成本納入評估。