自定義滾動條是提升 Web 應用原生感的關鍵細節。現代方案基於 **WebKit 偽元素標準** (Chrome、Edge、Safari、Opera 支持),Firefox 近期也支持 scrollbar-width/color。IE 專有屬性已棄用。本文提供完整實現方案。
/* 滾動條整體 */
::-webkit-scrollbar {
width: 8px; /* 垂直滾動條寬度 */
height: 8px; /* 水平滾動條高度 */
}
/* 滾動軌道 (背景) */
::-webkit-scrollbar-track {
background: #f1f1f1;
border-radius: 4px;
}
/* 滾動滑塊 (拖動塊) */
::-webkit-scrollbar-thumb {
background: #888;
border-radius: 4px;
border: 2px solid transparent;
background-clip: padding-box; /* 關鍵:留白形成邊距效果 */
}
::-webkit-scrollbar-thumb:hover {
background: #555;
}
::-webkit-scrollbar-thumb:active {
background: #333;
}
/* 滾動條兩端按鈕 (現代瀏覽器默認隱藏,可選啟用) */
::-webkit-scrollbar-button {
display: none; /* 隱藏上下箭頭按鈕 */
/* display: block; height: 16px; background: #ccc; */ /* 啟用時 */
}
/* 角落 (雙向滾動交叉區域) */
::-webkit-scrollbar-corner {
background: #f1f1f1;
}
/* 縮放手柄 (右下角) */
::-webkit-resizer {
background: url('resizer.png') center no-repeat;
}
| 偽類 | 作用對象 | 說明 |
|---|---|---|
:horizontal | 所有偽元素 | 水平滾動條專用樣式 |
:vertical | 所有偽元素 | 垂直滾動條專用樣式 |
:decrement | button, track-piece | 減小視圖位置的按鈕/軌道 (上/左) |
:increment | button, track-piece | 增大視圖位置的按鈕/軌道 (下/右) |
:start | button, thumb | 滑塊前側的按鈕/滑塊前端 |
:end | button, thumb | 滑塊後側的按鈕/滑塊後端 |
:double-button | button, track-piece | 同一端雙按鈕之一 |
:single-button | button, track-piece | 單獨按鈕 |
:no-button | track-piece | 無按鈕的軌道端部 |
:corner-present | track | 角落存在時 |
:window-inactive | 所有 | 非活動窗口/標籤頁 |
:hover, :active | thumb, button | 交互狀態 |
:enabled, :disabled | 所有 | 啟用/禁用狀態 |
:root {
--scrollbar-width: 8px;
--scrollbar-track: #f0f0f0;
--scrollbar-thumb: #c1c1c1;
--scrollbar-thumb-hover: #a8a8a8;
--scrollbar-thumb-active: #8c8c8c;
--scrollbar-radius: 4px;
}
@media (prefers-color-scheme: dark) {
:root {
--scrollbar-track: #2d2d2d;
--scrollbar-thumb: #555;
--scrollbar-thumb-hover: #666;
--scrollbar-thumb-active: #777;
}
}
/* 全局生效 */
::-webkit-scrollbar {
width: var(--scrollbar-width);
height: var(--scrollbar-width);
}
::-webkit-scrollbar-track {
background: var(--scrollbar-track);
border-radius: var(--scrollbar-radius);
}
::-webkit-scrollbar-thumb {
background: var(--scrollbar-thumb);
border-radius: var(--scrollbar-radius);
border: 2px solid transparent;
background-clip: padding-box;
}
::-webkit-scrollbar-thumb:hover {
background: var(--scrollbar-thumb-hover);
}
::-webkit-scrollbar-thumb:active {
background: var(--scrollbar-thumb-active);
}
::-webkit-scrollbar-corner {
background: var(--scrollbar-track);
}
/* 局部作用域 (如側邊欄、模態框) */
.sidebar::-webkit-scrollbar { width: 6px; }
.sidebar::-webkit-scrollbar-thumb { border-radius: 3px; }
/* 隱藏滾動條但保持滾動功能 */
.scroll-hidden::-webkit-scrollbar { display: none; }
.scroll-hidden { -ms-overflow-style: none; scrollbar-width: none; } /* Firefox/IE */
.custom-scroll {
/* 寬度:auto | thin | none */
scrollbar-width: thin;
/* 顏色:滑塊顏色 軌道顏色 */
scrollbar-color: #888 #f1f1f1;
}
/* 結合 WebKit 寫法 (推薦順序) */
.custom-scroll {
scrollbar-width: thin;
scrollbar-color: #888 #f1f1f1;
}
.custom-scroll::-webkit-scrollbar { width: 8px; height: 8px; }
.custom-scroll::-webkit-scrollbar-track { background: #f1f1f1; }
.custom-scroll::-webkit-scrollbar-thumb { background: #888; border-radius: 4px; }
.ie-scrollbar {
/* IE 5.5+ 專有,不標準,現代瀏覽器忽略 */
scrollbar-face-color: #888; /* 滑塊/按鈕顏色 */
scrollbar-track-color: #f1f1f1; /* 軌道顏色 */
scrollbar-arrow-color: #fff; /* 箭頭顏色 */
scrollbar-shadow-color: #aaa; /* 陰影顏色 */
scrollbar-darkshadow-color: #888; /* 深陰影 */
scrollbar-highlight-color: #fff; /* 高光 */
scrollbar-3dlight-color: #fff; /* 3D 高光 */
scrollbar-base-color: #ccc; /* 基礎色 (影響以上未設置項) */
}
<style>
:root {
--sb-track: #f0f0f0;
--sb-thumb: #c1c1c1;
}
[data-theme="dark"] {
--sb-track: #2d2d2d;
--sb-thumb: #555;
}
</style>
<script>
// 切換主題
document.documentElement.dataset.theme = 'dark'; // 或 'light'
// 運行時動態調整 (如根據內容長度顯示/隱藏)
const sidebar = document.querySelector('.sidebar');
const observer = new ResizeObserver(() => {
sidebar.style.setProperty('--show-scrollbar',
sidebar.scrollHeight > sidebar.clientHeight ? 'auto' : 'none');
});
observer.observe(sidebar);
</script>
display: none 隱藏功能@media print { ::-webkit-scrollbar { display: none; } }