组里有个轮播组件,从我进公司起就有,前后被改过七次。每次改动都是往同一个方向加东西:指针事件、惯性计算、触摸阈值、自动播放暂停、无障碍补丁。现在它的 JS 大概 600 行,还不算依赖的那个手势库。
前阵子接了个新页面,只要一个很朴素的图片轮播,左右两个箭头加底下一排圆点。把那个 600 行的组件搬过来,我看了看打包后的体积,决定试试 2025 年新出的那套 CSS 轮播特性。结论写在最前面:这次真的可以只写 CSS,但有几个地方跟直觉不一样,值得单独记下来。
先把地基打对:scroll-snap 是老朋友了
新的轮播特性并不是凭空造了一套东西,它建立在 scroll-snap 之上。所以在用伪元素之前,先把基础的横向滚动容器配好,后面所有特性都依赖这个前提。
<div class="carousel">
<ul>
<li><img src="p1.jpg" alt="山间清晨"></li>
<li><img src="p2.jpg" alt="城市夜色"></li>
<li><img src="p3.jpg" alt="海边日落"></li>
<li><img src="p4.jpg" alt="旷野星空"></li>
</ul>
</div>
.carousel {
overflow-x: auto;
scroll-snap-type: x mandatory;
scroll-behavior: smooth;
scrollbar-width: none;
}
.carousel::-webkit-scrollbar {
display: none;
}
.carousel > ul {
display: flex;
gap: 16px;
margin: 0;
padding: 0;
list-style: none;
}
.carousel > ul > li {
flex: 0 0 80%;
scroll-snap-align: center;
scroll-snap-stop: always;
}
scroll-snap-stop: always 这行别省。默认值是 normal,用户快速划一下有可能一次跳过三张,停在第 4 张。设成 always 之后,无论手势多快最多只停一格,这才符合”轮播”的语义。
到这里为止,这已经是一个能手动滑动、松手自动对齐的轮播了,只是没有箭头和圆点。
箭头是伪元素,不是 DOM
这就是新特性真正有意思的地方。滚动容器上有一个 ::scroll-button() 伪元素,参数决定方向:
.carousel::scroll-button(left) {
content: "←";
width: 44px;
height: 44px;
border-radius: 50%;
border: 1px solid #d9d9d9;
background: #fff;
color: #333;
font-size: 18px;
place-content: center;
cursor: pointer;
}
.carousel::scroll-button(right) {
content: "→";
/* 其余同上,实际项目里抽成一个共用规则 */
}
参数除了 left / right,也可以写 inline-start 和 inline-end,跟着书写方向走,做多语言的时候用逻辑值更省事。
这三个特性最舒服的一点是它不需要你写任何 JS 去监听点击。浏览器给这两个伪元素分配了 role="button" 和默认的可访问名称(大概是”向左滚动”这种),点击自动触发对应方向的滚动,滚动距离等于一个”页”的大小,并且会尊重 scroll-snap-type 的吸附。
更省心的是禁用状态。滚到最左边的时候,左边的按钮自动进入 :disabled 状态,滚到最右边则轮到右边。不用自己算 scrollLeft 和 scrollWidth:
.carousel::scroll-button(left):disabled,
.carousel::scroll-button(right):disabled {
opacity: 0.3;
cursor: not-allowed;
}
这里有个坑我卡了半天。伪元素默认不会继承你在容器上给的 position: relative 效果——它确实是静态定位,直接显示在内容流的末尾,而不是浮在图片上。我原以为加个 position: absolute 就行,结果发现伪元素跑到了滚动内容的外面,跟滚动条一起被裁掉了半个。
正确的做法是给滚动容器的外层再包一个定位容器,让两个箭头挂在外层:
<div class="carousel-wrap">
<div class="carousel">
<ul>...</ul>
</div>
</div>
.carousel-wrap {
position: relative;
}
.carousel::scroll-button(left),
.carousel::scroll-button(right) {
position: absolute;
top: 50%;
translate: 0 -50%;
z-index: 1;
}
.carousel::scroll-button(left) {
left: 12px;
}
.carousel::scroll-button(right) {
right: 12px;
}
虽然伪元素挂在 .carousel 上,但绝对定位的参照物是最近的定位祖先,也就是 .carousel-wrap。这样按钮就浮在轮播上面,不参与滚动,也不会被 overflow 裁剪。
圆点:先告诉容器把组放哪
底下一排小圆点,实现路径跟箭头不太一样。需要做两件事:
第一,在滚动容器上声明圆点组的插入位置:
.carousel {
scroll-marker-group: after;
}
这个属性只有两个值,before 或 after,意思是把圆点组插在内容的前面还是后面。网页轮播基本都是 after,圆点在底部。
第二,在每个可吸附的子元素上声明自己的标记:
.carousel > ul > li::scroll-marker {
content: "";
width: 8px;
height: 8px;
border-radius: 50%;
background: #ccc;
transition: background 0.2s, scale 0.2s;
}
这里有一点很关键:必须是 ::scroll-marker,而不是给 .carousel 自己加。标记点跟”哪一屏”绑在一起,所以每个能停靠的子元素生成自己的标记。
组容器 ::scroll-marker-group 本身也可以写样式了:
.carousel::scroll-marker-group {
display: flex;
justify-content: center;
gap: 8px;
margin-top: 12px;
}
组的定位这里也有坑。它默认会出现在滚动容器内部的内容流末尾,也就是说如果容器本身设置了 overflow: auto,组会被一起裁进去。想让圆点固定显示在下方、不占滚动区域,把它从滚动容器里”提”到外层:
.carousel-wrap::scroll-marker-group {
/* 注意:组是挂在滚动容器上的,不是 wrap */
}
这个思路走不通。真正的解法是把 scroll-marker-group: after 放在滚动容器上,然后接受组容器里流式布局,用 position: sticky 把它贴在底部:
.carousel::scroll-marker-group {
position: sticky;
bottom: 8px;
display: flex;
justify-content: center;
gap: 8px;
padding: 4px 8px;
}
但 sticky 会让圆点盖在图片上。我的选择是给滚动容器设置一个等于圆点高度的 padding-bottom,让圆点落在内容下方的空白里,不跟图片打架。这个方案比用绝对定位可靠,因为无论内容多少,圆点始终在可视区域里:
.carousel {
padding-bottom: 40px;
}
如果希望圆点完全脱离滚动容器、像传统轮播那样固定在图下方,另一个思路是用 scroll-marker-group 的 display: flex 配合 scroll-snap-align 之外的元素占位,但那会把 HTML 结构搞复杂。权衡之后我选了 sticky 方案。
当前项高亮,靠 :target-current
圆点除了显示位置,最重要的功能是”当前是第几张”。这个状态由 :target-current 伪类提供,绑定在 ::scroll-marker 上:
.carousel > ul > li::scroll-marker:target-current {
background: #1a1a1a;
scale: 1.4;
}
刷新之后你会发现它跟随滚动位置自动切换,不需要任何 JS。这是这套特性里我评价最高的一处,因为它解决了过去最容易算错的一个值:吸附完成后的当前索引。
需要注意一点::target-current 是基于”当前滚动目标”,而不是”离中心最近的一张图”。两者在大多数情况下等价,但如果你的对齐用的是 scroll-snap-align: start 且带 scroll-padding,观感上会有细微差异。如果想让视觉对齐和标记对齐完全一致,给每个 li 加 scroll-snap-stop: always 并统一用 center,是我的建议。
键盘可达性不用自己操心,但要检查
原生轮播最大的麻烦是键盘。旧组件里为了 Tab 顺序在两个箭头和每个圆点间切换,写了一大段 tabindex 管理代码。伪元素按钮自动继承了这一点——Chrome 里用 Tab 能焦点到左箭头,再 Tab 到右箭头,焦点环也会正常显示。
但还是得检查三件事。
第一,role 和可访问名称。浏览器默认给的名称是英文的,中文项目里屏幕阅读器读出来会有点别扭。虽然可以靠 aria-label 覆盖,但伪元素没法写属性,只能用 content 或者上下文影响。::scroll-button 的 content 是纯文本的时候,可访问名称一般会被替换成这段文字。所以我实际项目里 content 放的不是箭头字符,而是一个装饰性 SVG 或可读字符,配合 font-size: 0 或 opacity 用别的元素绘制视觉,这样名称可读且视觉可控。这个技巧不够优雅,等各家浏览器把可访问名称的取值方式统一之后应该会改善。
第二,Tab 顺序。如果页面里同时有多个轮播,伪元素生成的按钮会不会打乱页面级 Tab 顺序?实测不会,它按 DOM 顺序插入在滚动容器两端,和手写按钮的位置一致。
第三,指针事件。禁用状态的箭头虽然显示为半透明,但默认还能被点击(只是点击没有效果)。如果业务上不能允许”点了像没反应”,可以在不支持 pointer-events: none 自定义伪元素状态的环境里,用 :disabled 选择器加 pointer-events: none。
自动播放:这层还是得 JS
CSS 轮播特性最大的缺口在自动播放。滚动容器没有”每隔 5 秒前进一格”的原生能力,animation 也不能安全地驱动滚动位置。所以自动播放还得靠 JS,但需要写的量非常少了:
function autoplay(carousel, interval = 4000) {
let timer = null;
const next = () => {
const width = carousel.clientWidth * 0.8 + 16;
const max = carousel.scrollWidth - carousel.clientWidth;
if (carousel.scrollLeft + width >= max - 2) {
carousel.scrollTo({ left: 0, behavior: 'smooth' });
} else {
carousel.scrollBy({ left: width, behavior: 'smooth' });
}
};
const start = () => {
stop();
timer = setInterval(next, interval);
};
const stop = () => {
if (timer) clearInterval(timer);
timer = null;
};
// 用户交互时暂停,符合 WCAG 2.2.2 的要求
carousel.addEventListener('pointerdown', stop);
carousel.addEventListener('focusin', stop);
carousel.addEventListener('pointerup', start);
carousel.addEventListener('focusout', start);
start();
}
这段代码只跟滚动位置打交道,不再需要去测量每个子元素、处理惯性、管理中间状态。因为滚动本身已经交给浏览器了,JS 做的只是”定时推一把”。
注意 pointerdown / focusin 上的暂停监听,这满足 WCAG 里”可暂停的自动运动”那条。旧组件里我们是靠监视 touchstart 实现的,副作用是一年里偶尔会有用户报告”我碰了一下它就不动了”——因为他只是滑了一下想看看下一张,滑完之后没有触发 touchend 的补位逻辑。新实现里 pointerup 之后会恢复,这个 bug 也就顺带没了。
浏览器不支持怎么办
写这篇文章的时候,伪元素方案的支持面是 Chrome 135+ 和 Edge,Safari 和 Firefox 还差一截。所以这个组件不可能全量切过去,得有降级路径。
我的做法是先落地根基,再按需加装。根基是 scroll-snap,它在所有现代浏览器上都支持,所以基础版永远是”能手动滑动 + 松手吸附”。伪元素按钮和标记点完全是增强项:
@supports selector(::scroll-button(left)) {
.carousel::scroll-button(left) {
/* 只在支持时显示 */
}
.carousel::scroll-button(right) {
/* 只在支持时显示 */
}
}
同理,标记点也用 @supports selector(::scroll-marker) 包裹。不支持的环境里,用户看到的是没有箭头、没有圆点的纯滑动区域。如果产品经理坚持要有视觉引导,那时候再回退到 JS 组件——但根据我的经验,C 端页面里这部分用户占比不高,为了他们维护 600 行组件是不划算的。
还要注意一个很隐蔽的问题:@supports 里写 selector(::scroll-button(left)) 时,部分旧浏览器解析 @supports 本身就会报错,直接整块失效。稳妥的写法是外面再套一层 @media 或在基础样式里默认给滚动容器留足空间,这样即使伪元素不出现,页面布局也不会太难看。
完整结构拼起来
把前面所有细节叠到同一个文件里,最终的样子大概是:
.carousel-wrap {
position: relative;
}
.carousel {
overflow-x: auto;
scroll-snap-type: x mandatory;
scroll-behavior: smooth;
scrollbar-width: none;
scroll-marker-group: after;
padding-bottom: 40px;
}
.carousel::-webkit-scrollbar {
display: none;
}
.carousel > ul {
display: flex;
gap: 16px;
margin: 0;
padding: 0;
list-style: none;
}
.carousel > ul > li {
flex: 0 0 80%;
scroll-snap-align: center;
scroll-snap-stop: always;
}
.carousel > ul > li::scroll-marker {
content: "";
width: 8px;
height: 8px;
border-radius: 50%;
background: #ccc;
transition: background 0.2s, scale 0.2s;
}
.carousel > ul > li::scroll-marker:target-current {
background: #1a1a1a;
scale: 1.4;
}
.carousel::scroll-marker-group {
position: sticky;
bottom: 8px;
display: flex;
justify-content: center;
gap: 8px;
}
.carousel::scroll-button(left),
.carousel::scroll-button(right) {
position: absolute;
top: 50%;
translate: 0 -50%;
z-index: 1;
width: 44px;
height: 44px;
border-radius: 50%;
border: 1px solid #d9d9d9;
background: #fff;
color: #333;
display: grid;
place-content: center;
font-size: 18px;
cursor: pointer;
}
.carousel::scroll-button(left) {
content: "←";
left: 12px;
}
.carousel::scroll-button(right) {
content: "→";
right: 12px;
}
.carousel::scroll-button(left):disabled,
.carousel::scroll-button(right):disabled {
opacity: 0.3;
cursor: not-allowed;
pointer-events: none;
}
@media (prefers-reduced-motion: reduce) {
.carousel {
scroll-behavior: auto;
}
.carousel > ul > li::scroll-marker {
transition: none;
}
}
这份代码可以直接放进项目里用,没有一行 JS,没有任何依赖。要加自动播放就再挂一段前面给的那十行脚本。
迁移之后的体会
组件体积从 600 行 JS 加一个手势库,缩到了不到 120 行 CSS 和可选的几十行自动播放脚本。但真正让我觉得值的不是体积,而是可预测性。
老组件里最难维护的部分是”手势状态机”,什么时候算一次滑动、什么时候只算一次点按、快速连滑时中断动画的时机,每加一个功能就要重新想一遍状态转移。新方案里这套状态机根本不存在,因为它不再属于前端代码,而属于浏览器实现,行为的边界就是 scroll-snap 的规范。这既降低了出 bug 的概率,也让排查问题时能在规范层面对齐,而不是对着几行 hack 猜。
当然也不全是好处。目前浏览器对伪元素可访问名称的处理还没统一,做国际化项目时要么容忍默认的英文提示,要么退一步用 JS 包一层真实按钮。另外 ::scroll-marker-group 的布局限制也比想象中多,圆点做视觉定制时会撞到不少墙。
所以我现在的策略是:新组件优先用新特性写,老组件保持不动。这套方案适合在展示型页面里用,比如产品图集、活动 banner、卡片列表,不适合交互复杂、需要精细控制播放节奏的场景。如果你手里有一个像我们组那样的老轮播,建议别急着推翻重写,先用新特性做几个小模块跑上一两个月,摸清它的脾气,再决定要不要碰核心代码。

