瀏覽器原生的滾動條樣式能改的地方有限,很多時候設計稿會要求一根纖細、圓角、顏色配合品牌調性的滾動條。既然 CSS 改不動,那就自己用 div 做一根。
本文示範一個完整的自訂滾動條元件,支援四種操作:拖動滑塊、滾輪滾動、點擊軌道跳轉、懸停變色,並處理了內容高度不足時自動隱藏滾動條的情況。
結構很單純:#mainBox 是視窗(固定高度、overflow: hidden),#content 是內容(絕對定位,用 top 位移),.scrollDiv 是滑塊本身。
* {
margin: 0;
padding: 0;
}
#mainBox {
width: 250px;
height: 500px;
border: 1px #bbb solid;
position: relative;
overflow: hidden;
margin: 50px auto;
}
#content {
height: 1000px;
position: absolute;
left: 0;
top: 0;
}
.scrollDiv {
width: 6px;
position: absolute;
top: 0;
background: #666;
border-radius: 10px;
}
/* 章節類別 */
.m-catr{padding:15px 0 10px 12px;*padding:15px 0 10px 14px;}
.m-catr .tte{float:left; line-height:35px; text-align:left;font-size:14px; font-weight:bold; color:#5b98db;}
#content dl{width:225px; float:left; margin-top:10px;}
#content dl dt, .m-catr dl dd{float:left;width:100%; line-height:25px; text-align:left; color:#444;}
#content dl dt{font-weight:bold;}
#content dl dd{margin-left:12px;}
HTML 主體是一串 dl 章節清單,放在 #content 裡:
<!-- 章節類別 --> <div class="m-catr f-cb"> <div class="tte">章節類別</div> <div id="mainBox"> <div id="content"> <dl data-type="menu"> <dt>第一單元 科學是系統化了的知識</dt> <dd>1、千篇一律與千變萬化</dd> <dd>2、雙語言時代</dd> <dd>3、人們如何做出決策</dd> <dd>4、培養獨立工作和獨立思考的人</dd> </dl> <!-- 第二 ~ 第五單元結構相同,此處省略 --> </div> </div> </div> <!-- /章節類別 -->
要支援舊版 IE 與標準瀏覽器,得先寫三個小工具。這段程式碼的年代感很濃,但邏輯清楚:
var doc = document;
var _wheelData = -1;
var mainBox = doc.getElementById('mainBox');
function bind(obj, type, handler) {
var node = typeof obj == "string" ? $(obj) : obj;
if (node.addEventListener) {
node.addEventListener(type, handler, false);
} else if (node.attachEvent) {
node.attachEvent('on' + type, handler);
} else {
node['on' + type] = handler;
}
}
function mouseWheel(obj, handler) {
var node = typeof obj == "string" ? $(obj) : obj;
bind(node, 'mousewheel', function (event) {
var data = -getWheelData(event);
handler(data);
if (document.all) {
window.event.returnValue = false;
} else {
event.preventDefault();
}
});
//火狐
bind(node, 'DOMMouseScroll', function (event) {
var data = getWheelData(event);
handler(data);
event.preventDefault();
});
}
function getWheelData(event) {
var e = event || window.event;
return e.wheelDelta ? e.wheelDelta : e.detail * 40;
}
三個關鍵:mousewheel 給 IE/WebKit、DOMMouseScroll 給 Firefox;wheelDelta 與 detail * 40 是兩套方向相反的數值系統,乘 40 是為了統一刻度;preventDefault() / returnValue = false 則阻止原生滾動同時發生。
整個元件用建構子 + 原型方法組織,init 依序掛上五件事:建立滑塊、調整尺寸、綁定拖曳、綁定滾輪、綁定點擊。
function addScroll() {
this.init.apply(this, arguments);
}
addScroll.prototype = {
init: function (mainBox, contentBox, className) {
var mainBox = doc.getElementById(mainBox);
var contentBox = doc.getElementById(contentBox);
var scrollDiv = this._createScroll(mainBox, className);
this._resizeScorll(scrollDiv, mainBox, contentBox);
this._tragScroll(scrollDiv, mainBox, contentBox);
this._wheelChange(scrollDiv, mainBox, contentBox);
this._clickScroll(scrollDiv, mainBox, contentBox);
},
//創建滾動條
_createScroll: function (mainBox, className) {
var _scrollBox = doc.createElement('div');
_scrollBox.setAttribute("id", "scrollBox");
var _scroll = doc.createElement('div');
var span = doc.createElement('span');
_scrollBox.appendChild(_scroll);
_scroll.appendChild(span);
_scroll.className = className;
mainBox.appendChild(_scrollBox);
return _scroll;
},
//調整滾動條
_resizeScorll: function (element, mainBox, contentBox) {
var p = element.parentNode;
var conHeight = contentBox.offsetHeight;
var _width = mainBox.clientWidth;
var _height = mainBox.clientHeight;
var _scrollWidth = element.offsetWidth;
var _left = _width - _scrollWidth;
p.style.width = _scrollWidth + "px";
p.style.height = _height + "px";
p.style.left = _left + "px";
p.style.position = "absolute";
p.style.background = "#ccc";
contentBox.style.width = (mainBox.offsetWidth - _scrollWidth) + "px";
var _scrollHeight = parseInt(_height * (_height / conHeight));
if (_scrollHeight >= mainBox.clientHeight) {
element.parentNode.style.display = "none";
}
element.style.height = _scrollHeight + "px";
},
_resizeScorll 是整個元件的核心數學:滑塊高度 = 視窗高度 × (視窗高度 ÷ 內容高度)。內容越長,滑塊越短,這正是原生滾動條的比例邏輯。若算出來的高度等於或大於視窗,代表根本不需要滾動,就把整根滾動條隱藏起來。
接著是拖曳與滾輪:
//拖動滾動條
_tragScroll: function (element, mainBox, contentBox) {
var mainHeight = mainBox.clientHeight;
element.onmousedown = function (event) {
var _this = this;
var _scrollTop = element.offsetTop;
var e = event || window.event;
var top = e.clientY;
document.onmousemove = scrollGo;
document.onmouseup = function (event) {
this.onmousemove = null;
}
function scrollGo(event) {
var e = event || window.event;
var _top = e.clientY;
var _t = _top - top + _scrollTop;
if (_t > (mainHeight - element.offsetHeight)) {
_t = mainHeight - element.offsetHeight;
}
if (_t <= 0) {
_t = 0;
}
element.style.top = _t + "px";
contentBox.style.top = -_t * (contentBox.offsetHeight / mainBox.offsetHeight) + "px";
_wheelData = _t;
}
}
element.onmouseover = function () {
this.style.background = "#444";
}
element.onmouseout = function () {
this.style.background = "#666";
}
},
//鼠標滾輪滾動,滾動條滾動
_wheelChange: function (element, mainBox, contentBox) {
var node = typeof mainBox == "string" ? $(mainBox) : mainBox;
var flag = 0, rate = 0, wheelFlag = 0;
if (node) {
mouseWheel(node, function (data) {
wheelFlag += data;
if (_wheelData >= 0) {
flag = _wheelData;
element.style.top = flag + "px";
wheelFlag = _wheelData * 12;
_wheelData = -1;
} else {
flag = wheelFlag / 12;
}
if (flag <= 0) {
flag = 0;
wheelFlag = 0;
}
if (flag >= (mainBox.offsetHeight - element.offsetHeight)) {
flag = (mainBox.clientHeight - element.offsetHeight);
wheelFlag = (mainBox.clientHeight - element.offsetHeight) * 12;
}
element.style.top = flag + "px";
contentBox.style.top = -flag * (contentBox.offsetHeight / mainBox.offsetHeight) + "px";
});
}
},
_clickScroll: function (element, mainBox, contentBox) {
var p = element.parentNode;
p.onclick = function (event) {
var e = event || window.event;
var t = e.target || e.srcElement;
var sTop = document.documentElement.scrollTop > 0 ? document.documentElement.scrollTop : document.body.scrollTop;
var top = mainBox.offsetTop;
var _top = e.clientY + sTop - top - element.offsetHeight / 2;
if (_top <= 0) {
_top = 0;
}
if (_top >= (mainBox.clientHeight - element.offsetHeight)) {
_top = mainBox.clientHeight - element.offsetHeight;
}
if (t != element) {
element.style.top = _top + "px";
contentBox.style.top = -_top * (contentBox.offsetHeight / mainBox.offsetHeight) + "px";
_wheelData = _top;
}
}
}
}
new addScroll('mainBox', 'content', 'scrollDiv');
$(function () {
$("#scrollBox").hide();
$("#mainBox").mouseover(function () {
$("#scrollBox").show();
}).mouseout(function () {
$("#scrollBox").hide();
});
});
拖曳時把 mousemove 綁在 document 上。 滑鼠滑得比滑塊快時,如果監聽元素本身會「失焦」導致拖動中斷。綁在 document 上、放開時再解除,是拖曳元件的標準做法。
位移量用比例換算。 不論拖曳、滾輪還是點擊,最後都回到同一條公式:content.top = -滑塊top × (內容高 ÷ 視窗高)。這個比例關係一旦建立,三種輸入方式就能共用同一套輸出邏輯。
_wheelData 作為拖曳與滾輪的橋樑。 拖曳結束後把位置寫進這個全域變數,滾輪 handler 下次執行時先讀它來同步,避免兩種操作互相打架。
今天若重寫這個元件,會改用 Pointer Events 統一處理滑鼠與觸控、用 CSS 變數 transform: translateY() 代替 top 以走 GPU 合成、並加上 requestAnimationFrame 節流。但作為教學範例,這份程式碼把「自訂滾動條」的完整思路——比例計算、事件綁定、輸入統一——交代得非常透徹。