萬盛學電腦網

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

CSS 自定義滾動條樣式完整指南:WebKit 偽元素與 IE 專有屬性對比

CSS 滾動條樣式化完全指南:WebKit 標準化方案與 IE 歷史方案對比

自定義滾動條是提升 Web 應用原生感的關鍵細節。現代方案基於 **WebKit 偽元素標準** (Chrome、Edge、Safari、Opera 支持),Firefox 近期也支持 scrollbar-width/color。IE 專有屬性已棄用。本文提供完整實現方案。

WebKit/Blink 偽元素體系 (Chrome 1+, Safari 3+, Edge 79+, Opera 15+)

/* 滾動條整體 */
::-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所有偽元素垂直滾動條專用樣式
:decrementbutton, track-piece減小視圖位置的按鈕/軌道 (上/左)
:incrementbutton, track-piece增大視圖位置的按鈕/軌道 (下/右)
:startbutton, thumb滑塊前側的按鈕/滑塊前端
:endbutton, thumb滑塊後側的按鈕/滑塊後端
:double-buttonbutton, track-piece同一端雙按鈕之一
:single-buttonbutton, track-piece單獨按鈕
:no-buttontrack-piece無按鈕的軌道端部
:corner-presenttrack角落存在時
:window-inactive所有非活動窗口/標籤頁
:hover, :activethumb, 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 */

Firefox 現代標準屬性 (Firefox 64+)

.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/舊 Edge 專有屬性 (已棄用,僅維護極舊項目參考)

.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;        /* 基礎色 (影響以上未設置項) */
}

高級技巧:CSS 變量 + JS 動態主題切換

<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>

性能與無障礙注意事項

  • 不要過度裝飾:滾動條是功能性 UI,過度設計降低可發現性
  • 保持足夠對比度:滑塊與軌道對比度 ≥ 3:1 (WCAG AA 非文本對比)
  • 保留鍵盤操作:鍵盤用戶依賴滾動條導航,勿 display: none 隱藏功能
  • 觸摸設備:移動端通常無滾動條 (觸摸滾動),樣式僅桌面端生效
  • 打印樣式:@media print { ::-webkit-scrollbar { display: none; } }

知名網站實現參考

  • **GitHub**:極簡灰色細條,懸停加粗,完美適配明/暗模式
  • **VS Code Web** : 完整原生感滾動條,支持拖拽、點擊軌道跳轉
  • **Figma** : 自定義細滾動條,配合畫布縮放指示器
  • **Notion** : 隱藏原生滾動條,自定義浮動滾動指示器
copyright © 萬盛學電腦網 all rights reserved