萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

CSS 滾動條樣式化完整指南:標準屬性與 WebKit 專屬屬性

自訂捲軸樣式能提升品牌一致性與使用者體驗。現代 CSS 提供標準化的 scrollbar-* 屬性,但瀏覽器支援度仍以 WebKit/Blink 核心的 ::-webkit-scrollbar 偽元素最完整。本文完整整理兩套語法、支援現況與最佳實務。

一、標準化 CSS Scrollbar 樣式 (CSS Scrollbars Styling Module Level 1)

適用於 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/Blink 專屬偽元素 (Chrome, Edge, Safari, Opera 完整支援)

提供精細控制:滑塊、軌道、按鈕、角落、雙端按鈕等。

偽元素對應部件常用樣式
::-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;
}

四、瀏覽器支援現況 (2024)

瀏覽器標準 scrollbar-*WebKit 偽元素
Chrome121+全版本
Edge121+全版本
Firefox64+不支援
Safari15.4+全版本
Opera107+全版本

五、最佳實務策略

  1. 漸進增強: 先寫標準 scrollbar-color/width,再用 @supports not (scrollbar-width: thin) 或直接疊加 WebKit 偽元素作為增強。
  2. 不要隱藏捲軸除非必要: scrollbar-width: none 或 ::-webkit-scrollbar { display: none } 會讓鍵盤/螢幕閱讀器使用者無法感知可滾動區域。若必須隱藏,請提供明確視覺提示 (如淡入淡出箭頭、捲動指示器)。
  3. 保持足夠對比度: 滑塊與軌道對比度 ≥ 3:1 (WCAG 非文字對比)。
  4. 觸控裝置: 行動裝置通常不顯示捲軸 (觸控滾動),桌面版才需美化。
  5. 避免過度裝飾: 捲軸是 UI 基礎元件,過度設計反而降低辨識度。

六、常見陷阱

  • 作用對象錯誤: 捲軸樣式必須套用在產生捲動的容器 (有 overflow: auto/scroll 的元素),而非 body 或內容元素 (除非 body 本身滾動)。
  • 與 overflow: hidden 衝突: 容器若 overflow: hidden 則無捲軸可美化。
  • iframe 內部捲軸: 需在 iframe 內部文檔的容器設定樣式,跨域受同源策略限制無法從父頁面控制。

掌握雙軌制語法與支援現況,即可打造跨瀏覽器一致且優雅的捲軸體驗。

copyright © 萬盛學電腦網 all rights reserved