自訂捲軸樣式能提升品牌一致性與使用者體驗。現代 CSS 提供標準化的 scrollbar-* 屬性,但瀏覽器支援度仍以 WebKit/Blink 核心的 ::-webkit-scrollbar 偽元素最完整。本文完整整理兩套語法、支援現況與最佳實務。
適用於 Firefox 64+、Chrome 121+、Edge 121+、Safari 15.4+ (支援度持續擴大中)。
| 屬性 | 說明 | 值範例 |
|---|---|---|
scrollbar-color | 設定滾動條滑塊(thumb)與軌道(track)顏色 | scrollbar-color: #888 #f1f1f1; (thumb track) |
scrollbar-width | 設定滾動條寬度 | auto (預設)、thin (細)、none (隱藏但可滾動) |
/* 標準寫法:作用於滾動容器 */
.scroll-container {
scrollbar-color: #666 #eee; /* 滑塊顏色、軌道顏色 */
scrollbar-width: thin; /* 細捲軸 */
}
/* 隱藏捲軸但保持可滾動 */
.hide-scrollbar {
scrollbar-width: none; /* Firefox */
-ms-overflow-style: none; /* IE/Edge 舊版 */
}
.hide-scrollbar::-webkit-scrollbar { display: none; } /* WebKit */
提供精細控制:滑塊、軌道、按鈕、角落、雙端按鈕等。
| 偽元素 | 對應部件 | 常用樣式 |
|---|---|---|
::-webkit-scrollbar | 整個捲軸區域 | width: 8px; height: 8px; (垂直/水平寬度) |
::-webkit-scrollbar-track | 軌道背景 | background: #f1f1f1; border-radius: 4px; |
::-webkit-scrollbar-track-piece | 軌道未被滑塊覆蓋部分 | 漸層、分段顏色 |
::-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; 隱藏、或設定背景圖示 |
::-webkit-scrollbar-corner | 垂直/水平捲軸交角 | background: #f1f1f1; |
::-webkit-scrollbar:horizontal | 水平捲軸特定樣式 | 覆寫高度、軌道高度 |
::-webkit-scrollbar:vertical | 垂直捲軸特定樣式 | 覆寫寬度 |
::-webkit-scrollbar:decrement | 遞減按鈕 (上/左) | 箭頭樣式 |
::-webkit-scrollbar:increment | 遞增按鈕 (下/右) | 箭頭樣式 |
/* 1. 標準屬性 (Firefox、新版 Chrome/Edge/Safari) */
.dark-scroll {
scrollbar-color: #888 #2d2d2d;
scrollbar-width: thin;
}
/* 2. WebKit 精細樣式 (Chrome/Edge/Safari) */
.dark-scroll::-webkit-scrollbar {
width: 10px;
height: 10px;
}
.dark-scroll::-webkit-scrollbar-track {
background: #2d2d2d;
border-radius: 5px;
}
.dark-scroll::-webkit-scrollbar-thumb {
background: #888;
border-radius: 5px;
border: 2px solid #2d2d2d; /* 建立內邊距效果 */
background-clip: padding-box;
}
.dark-scroll::-webkit-scrollbar-thumb:hover {
background: #aaa;
}
.dark-scroll::-webkit-scrollbar-thumb:active {
background: #ccc;
}
.dark-scroll::-webkit-scrollbar-button {
display: none; /* 隱藏箭頭按鈕 */
}
.dark-scroll::-webkit-scrollbar-corner {
background: #2d2d2d;
}
| 瀏覽器 | 標準 scrollbar-* | WebKit 偽元素 |
|---|---|---|
| Chrome | 121+ | 全版本 |
| Edge | 121+ | 全版本 |
| Firefox | 64+ | 不支援 |
| Safari | 15.4+ | 全版本 |
| Opera | 107+ | 全版本 |
scrollbar-color/width,再用 @supports not (scrollbar-width: thin) 或直接疊加 WebKit 偽元素作為增強。scrollbar-width: none 或 ::-webkit-scrollbar { display: none } 會讓鍵盤/螢幕閱讀器使用者無法感知可滾動區域。若必須隱藏,請提供明確視覺提示 (如淡入淡出箭頭、捲動指示器)。overflow: auto/scroll 的元素),而非 body 或內容元素 (除非 body 本身滾動)。overflow: hidden 衝突: 容器若 overflow: hidden 則無捲軸可美化。掌握雙軌制語法與支援現況,即可打造跨瀏覽器一致且優雅的捲軸體驗。