You need to enable JavaScript to run this app. 滚动动画页面中如何禁用图片的横向滚动功能?
优惠活动
大模型
产品
解决方案
定价
更多

滚动动画页面中如何禁用图片的横向滚动功能?

解决方案

首选方案:使用CSS touch-action 属性(无副作用,符合你的限制条件)

该方案不需要修改元素的position属性,也不依赖overflow配置,直接从触摸事件层面限制可滚动方向:

/* 给所有可能出现横向滚动的目标元素加上该属性 */
.target-element {
  touch-action: pan-y;
  /* 如果需要完全禁用该元素上所有滚动行为,可以替换为 touch-action: none; 按需调整即可 */
}
  • touch-action: pan-y 会明确告知浏览器,仅允许响应该元素上的纵向触摸滚动操作,所有横向触摸滑动、缩放操作都会被直接拦截,不会触发元素内部的横向滚动
  • 兼容性覆盖全量主流移动端浏览器,包括iOS Safari 13.4+、安卓Chrome 55+,无额外性能损耗

备选方案:JS 事件拦截(兼容极端场景)

如果存在低版本浏览器兼容需求,可以通过监听触摸事件判断滑动方向,拦截横向滚动行为:

let startX = 0;
let startY = 0;
const targetEl = document.querySelector('.target-element');

targetEl.addEventListener('touchstart', (e) => {
  startX = e.touches[0].clientX;
  startY = e.touches[0].clientY;
}, { passive: false });

targetEl.addEventListener('touchmove', (e) => {
  const moveX = e.touches[0].clientX - startX;
  const moveY = e.touches[0].clientY - startY;
  // 横向位移大于纵向位移时判定为横向滚动,拦截默认行为
  if (Math.abs(moveX) > Math.abs(moveY)) {
    e.preventDefault();
  }
}, { passive: false });
  • 注意必须设置passive: false才能正常调用preventDefault
  • 该方案不会影响纵向滚动逻辑,也不会修改元素的样式属性,适配你的动画限制条件

补充优化:从源头避免元素尺寸溢出

如果是图片、视频等可替换元素自身宽度超出视口导致的滚动,可以优先从根源消除触发条件:

img, video {
  max-width: 100%;
  height: auto;
}

内容的提问来源于stack exchange,提问作者Simon Benedikt Fischer

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.10 07:09:02