CSS如何创建自定义滚动条？::-webkit-scrollbar指南

自定义滚动条主要通过::-webkit-scrollbar及其子伪元素实现，1. 使用::-webkit-scrollbar设置滚动条宽高；2. 用::-webkit-scrollbar-track定义轨道样式；3. 用::-webkit-scrollbar-thumb设置滑块样式；4. 可选地使用::-webkit-scrollbar-corner和::-webkit-scrollbar-button调整角落和按钮；该方案仅兼容webkit内核浏览器如chrome、safari和新版edge，firefox及其他非webkit浏览器不支持；若需跨浏览器一致性，可采用javascript库如perfect scrollbar作为替代方案；为特定元素应用样式时，需将元素选择器与伪元素结合使用，如#my-div::-webkit-scrollbar；设计时应避免过度隐藏、对比度不足等问题，保持简洁、可操作性和与整体风格统一，确保良好用户体验。

要用CSS自定义滚动条，主要依靠

::-webkit-scrollbar

伪元素及其一系列子伪元素。这套规则允许你精细控制滚动条的各个部分，从宽度到颜色，甚至边角，但需要注意的是，它的兼容性目前主要局限于基于WebKit内核的浏览器，比如Chrome、Safari以及一些国内的浏览器。

解决方案

创建自定义滚动条，核心在于理解

::-webkit-scrollbar

及其几个关键的子伪元素。它们就像是把一个完整的滚动条拆解成了几个独立的、可以单独造型的部分。

首先，

::-webkit-scrollbar

本身用于定义整个滚动条的尺寸。比如，你想让滚动条变窄一点，或者宽一点，就在这里设置

width

（垂直滚动条）或

height

（水平滚动条）。

立即学习“前端免费学习笔记（深入）”；

/* 定义整个滚动条的宽度 */ ::-webkit-scrollbar {     width: 10px; /* 垂直滚动条的宽度 */     height: 10px; /* 水平滚动条的高度 */ }

接着，是滚动条的“轨道”部分，也就是滚动条的背景区域。这部分用

::-webkit-scrollbar-track

来控制。你可以在这里设置背景色、圆角，甚至阴影。我个人比较喜欢给它一个淡淡的背景色，或者让它透明，这样滚动条不会显得太突兀。

/* 滚动条轨道 */ ::-webkit-scrollbar-track {     background: #f1f1f1; /* 轨道背景色 */     border-radius: 5px; /* 轨道圆角 */     /* box-shadow: inset 0 0 5px rgba(0,0,0,0.1); */ /* 也可以加阴影 */ }

然后是“滑块”，也就是你拖动的那一部分。这个是

::-webkit-scrollbar-thumb

。这是滚动条最显眼的部分，颜色、圆角、甚至鼠标悬停时的样式，都可以在这里定义。我通常会给它一个比轨道深一点的颜色，并且加上圆角，让它看起来更柔和。

/* 滚动条滑块 */ ::-webkit-scrollbar-thumb {     background: #888; /* 滑块颜色 */     border-radius: 5px; /* 滑块圆角 */ }  /* 滑块悬停样式 */ ::-webkit-scrollbar-thumb:hover {     background: #555; /* 鼠标悬停时颜色变深 */ }

此外，还有一些不那么常用但偶尔有用的部分：

• ::-webkit-scrollbar-corner

  : 当内容同时有垂直和水平滚动条时，它们相交的那个角落。这个通常很少去改动，但如果你想让整个滚动条区域都保持统一风格，可以考虑。

• ::-webkit-scrollbar-button

  : 滚动条两端的按钮（如果有的话）。很多时候我们看到的滚动条是没有这些按钮的，所以这部分也用得比较少。

/* 滚动条角落 */ ::-webkit-scrollbar-corner {     background: #ccc; }  /* 滚动条按钮 (上下左右箭头) */ ::-webkit-scrollbar-button {     /* display: none; */ /* 多数情况下选择隐藏 */     background: #eee; }

把这些组合起来，就能得到一个基本的自定义滚动条了。我的习惯是先从最简单的颜色和宽度开始，然后根据实际设计需要再慢慢调整圆角、阴影之类的细节。

为什么我的自定义滚动条在Firefox或Microsoft Edge上不生效？有没有通用的解决方案？

说实话，这是自定义滚动条最让人头疼的地方。你辛辛苦苦写好的

::-webkit-scrollbar

代码，在Chrome里跑得好好的，一到Firefox或者新的Microsoft Edge（基于Chromium内核之前），瞬间就“失效”了。这并不是你的代码写错了，而是因为这些伪元素是WebKit内核浏览器特有的。

Firefox在过去尝试过

-moz-scrollbar

类似的私有属性，但现在已经不推荐使用了，或者说支持度非常有限。对于新版的Microsoft Edge，因为它现在也基于Chromium内核了，所以

::-webkit-scrollbar

是生效的。但在此之前的旧版Edge（EdgeHTML内核）和IE，它们压根就不认识这套东西。

所以，目前并没有一个真正“通用”的CSS解决方案能让所有浏览器都支持自定义滚动条。这听起来有点沮丧，但这就是前端开发中浏览器兼容性的一个真实写照。

面对这种情况，我的处理方式通常是这样的：

1. 接受现实，优先WebKit内核浏览器体验： 既然

   ::-webkit-scrollbar

   在主流的Chrome、Safari和新Edge上都能用，那就先把它做好。对于这些用户，他们能看到你精心设计的滚动条。

2. 对其他浏览器保持默认： 对于Firefox等不支持的浏览器，它们会显示各自浏览器默认的滚动条样式。这通常是可接受的，毕竟用户已经习惯了他们浏览器自带的样式。除非设计上对滚动条的视觉要求非常高，否则没必要为了一个次要的UI元素去过度优化。
3. 如果非要全浏览器统一，考虑JavaScript库： 如果你的项目对滚动条的视觉统一性有极高的要求，那么CSS就无能为力了。这时，你可能需要引入一些JavaScript库，比如Perfect Scrollbar、OverlayScrollbars等。这些库的原理通常是模拟一个自定义滚动条，然后通过JavaScript控制内容区域的滚动，从而实现跨浏览器的一致性。但引入JS库会增加页面的JS负载和复杂度，而且可能会带来一些潜在的性能问题或与现有JS冲突，所以这通常是我的“最后手段”。

对我来说，最务实的做法是利用好

::-webkit-scrollbar

，让大部分用户获得更好的体验，同时不强求所有浏览器都完美一致，保持一种“优雅降级”的心态。毕竟，滚动条首先是功能性的，其次才是美观的。

设计自定义滚动条时有哪些常见误区和最佳实践？

设计自定义滚动条，很容易陷入一些误区，导致用户体验反而变差。我见过不少设计，初衷是想让页面更美观，结果却适得其反。

常见误区：

1. 过度隐藏或缩小滚动条： 有些设计师为了追求“极简”，把滚动条做得非常细，甚至透明度很高，导致用户很难发现它的存在，或者很难精确拖动。滚动条是重要的交互元素，它的可见性和可操作性至关重要。
2. 颜色对比度不足： 滑块和轨道的颜色过于接近，或者和页面背景色混淆，导致滚动条难以辨认。这不仅影响美观，更影响可用性，尤其对于视力有障碍的用户来说。
3. 忽略

   :hover

   状态： 很多人只设置了默认状态，忘记了鼠标悬停在滑块或轨道上时的样式。一个有反馈的

   :hover

   状态能极大地提升用户体验，告诉他们“这里可以交互”。

4. 滥用圆角或复杂样式： 过多的圆角、渐变、阴影，甚至背景图片，会让滚动条看起来过于花哨，分散用户注意力，甚至显得廉价。有时候，简洁就是美。
5. 不考虑内容长度： 当内容很短，不足以出现滚动条时，却仍然显示一个空的轨道或者一个很小的滑块。虽然通常浏览器会处理这种情况，但如果设计过于激进，可能会出现意想不到的视觉问题。

最佳实践：

1. 保持可见性和可操作性： 确保滚动条的宽度足够，颜色对比度适中，让用户一眼就能看到并轻松操作。通常，垂直滚动条的宽度在8px到12px之间比较合适。
2. 提供清晰的视觉反馈： 为

   ::-webkit-scrollbar-thumb:hover

   设置一个明显的颜色变化，让用户知道他们可以与滚动条交互。这是一种非常基础但有效的用户体验提升。

3. 与整体设计风格统一： 滚动条的颜色和形状应该与你的网站或应用整体的设计语言保持一致。如果你的网站是扁平化设计，那么滚动条也应该是简洁的扁平风格；如果是拟物化，可以适当增加一些光影效果。
4. 考虑无障碍性： 虽然

   ::-webkit-scrollbar

   本身在无障碍性方面有局限，但在设计颜色时，尽量遵循WCAG（Web内容无障碍指南）的对比度建议，确保足够的对比度。

5. 测试不同屏幕尺寸和设备： 在不同的分辨率和设备上测试你的自定义滚动条，确保它在各种情况下都能正常显示和操作，不会出现奇怪的布局问题。
6. 简单为王： 我个人的经验是，大多数时候，一个简单的、颜色协调的滚动条就足够了。一个合适的宽度，一个区分度高的滑块颜色，加上一个简单的hover效果，往往比那些花里胡哨的设计更实用、更耐看。记住，滚动条是辅助工具，不是页面的主角。

如何为特定元素（而非整个页面）应用自定义滚动条样式？

很多时候，我们并不想改变整个页面的滚动条样式，而只是想为某个特定的

div

容器、弹窗或者侧边栏应用自定义的滚动条。这是完全可以实现的，而且方法非常直接。

::-webkit-scrollbar

伪元素可以像其他CSS选择器一样，与你的元素选择器结合使用。你只需要把

::-webkit-scrollbar

及其子伪元素放在你想要应用样式的元素选择器后面即可。

例如，假设你有一个ID为

my-scrollable-div

的

div

，你想让它的滚动条变成蓝色，而页面的其他部分保持默认。你可以这样写：

<div id="my-scrollable-div" style="height: 200px; overflow-y: scroll;">     <!-- 这里放很多内容，多到可以滚动 -->     <p>这是第一行内容...</p>     <p>这是第二行内容...</p>     <!-- ... 更多行 ... -->     <p>这是最后一行内容...</p> </div>

然后，在你的CSS中：

/* 针对ID为my-scrollable-div的元素及其内部的滚动条 */ #my-scrollable-div::-webkit-scrollbar {     width: 8px; /* 宽度可以稍微窄一点 */ }  #my-scrollable-div::-webkit-scrollbar-track {     background: #e0f2f7; /* 浅蓝色轨道 */     border-radius: 4px; }  #my-scrollable-div::-webkit-scrollbar-thumb {     background: #3498db; /* 深蓝色滑块 */     border-radius: 4px; }  #my-scrollable-div::-webkit-scrollbar-thumb:hover {     background: #2980b9; /* 悬停时颜色更深 */ }

通过这种方式，只有

#my-scrollable-div

内部的滚动条会显示你自定义的蓝色样式，而

body

或者其他没有指定样式的可滚动元素，它们的滚动条会保持浏览器默认的样式。

如果你有很多类似的元素需要相同的自定义滚动条，但又不想每个都写一遍，可以给它们添加一个共同的类名，比如

.custom-scroll

：

<div class="custom-scroll" style="height: 150px; overflow-y: scroll;">     <!-- 内容 --> </div>  <aside class="custom-scroll" style="height: 300px; overflow-y: scroll;">     <!-- 侧边栏内容 --> </aside>

然后CSS这样写：

/* 针对所有带有.custom-scroll类的元素 */ .custom-scroll::-webkit-scrollbar {     width: 6px; /* 窄一点的滚动条 */ }  .custom-scroll::-webkit-scrollbar-track {     background: rgba(0,0,0,0.1); /* 半透明浅色轨道 */ }  .custom-scroll::-webkit-scrollbar-thumb {     background: rgba(0,0,0,0.5); /* 半透明深色滑块 */     border-radius: 3px; }  .custom-scroll::-webkit-scrollbar-thumb:hover {     background: rgba(0,0,0,0.7); }

这种做法非常灵活，能够让你在不影响全局样式的前提下，对特定区域的滚动条进行精细控制。我经常用这种方法来处理弹窗或者侧边抽屉里的内容区域，因为这些区域的滚动条往往需要和整体UI风格更匹配。