纯 CSS 轮播落地记:scroll-button 与 scroll-marker 能替掉多少 JS

2026-11-14 0 890

组里有个轮播组件,从我进公司起就有,前后被改过七次。每次改动都是往同一个方向加东西:指针事件、惯性计算、触摸阈值、自动播放暂停、无障碍补丁。现在它的 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、卡片列表,不适合交互复杂、需要精细控制播放节奏的场景。如果你手里有一个像我们组那样的老轮播,建议别急着推翻重写,先用新特性做几个小模块跑上一两个月,摸清它的脾气,再决定要不要碰核心代码。

纯 CSS 轮播落地记:scroll-button 与 scroll-marker 能替掉多少 JS
收藏 (0) 打赏

感谢您的支持,我会继续努力的!

打开微信/支付宝扫一扫,即可进行扫码打赏哦,分享从这里开始,精彩与您同在
点赞 (0)

版权声明:
本站资源有的来自互联网收集整理,本站纯免费分享提供学习使用,如果侵犯了您的合法权益,请发送邮件1506151422@qq.com联系,将会及时下架删除。
本站资源仅供研究、学习交流之用,免费开源项目不代表完全可商用,若商业用途请先咨询开发企业能否商用,否则产生的一切后果将由下载用户自行承担。
原创板块未经允许不得转载,否则将追究法律责任。

淘吗网 css 纯 CSS 轮播落地记:scroll-button 与 scroll-marker 能替掉多少 JS https://www.taomawang.com/web/css/3017.html

常见问题

相关文章

猜你喜欢
发表评论
暂无评论
官方客服团队

为您解决烦忧 - 24小时在线 专业服务