为什么CSS touch-action在iOS Safari中不生效

老辰小哥_1712

老辰小哥_1712

2026-08-07

1021人浏览

原创

touch-action: manipulation 在 ios safari 13.4 前完全不生效,是因 safari 实现滞后而非 bug;12.x 和 13.0–13.3 版本直接忽略该值回退为 auto,300ms 延迟仍存在;需用 @supports 包裹、降级为 pan-y pinch-zoom 或 -webkit-touch-callout: none,并注意父级 touch-action: none 会强制覆盖子元素设置。

为什么css touch-action在ios safari中不生效

touch-action: manipulation 在 iOS Safari 13.4 之前完全不解析

这不是 bug,是 Safari 实现滞后——iOS Safari 直到 13.4 才开始完整支持 touch-action: manipulation。12.x 和 13.0–13.3 版本会直接忽略该声明,回退为 touch-action: auto,300ms 点击延迟照常存在。

实操建议:

  • 用 @supports (touch-action: manipulation) 包裹样式,避免低版本误解析或干扰其他规则
  • 真机测试必须覆盖 iOS 12.5.7 和 13.3 —— 这两个仍是部分企业内网设备主力版本
  • 降级方案:对旧版改用 touch-action: pan-y pinch-zoom(保留滚动+双指缩放),或加 -webkit-touch-callout: none 抑制长按唤出缩放菜单

父容器 touch-action: none 强制覆盖子元素设置

CSS 的 touch-action 不支持子元素“覆盖”父级设置。只要祖先节点(哪怕只是 div#app)设了 touch-action: none,其所有后代即使显式写 touch-action: manipulation 也无效。

常见错误场景:

Plan Dubai Travel — Flights, Hotels, Burj Khalifa, Desert Safari, Malls & Itineraries
Plan Dubai Travel — Flights, Hotels, Burj Khalifa, Desert Safari, Malls & Itineraries

规划您的迪拜之旅 — 哈利法塔观景、沙漠探险、迪拜购物中心购物、棕榈岛度假村及黄金市场砍价。还提供支持...

下载
  • UI 框架(如 Vant、Naive UI)初始化时给根容器设了 touch-action: none,你自己的按钮加了 manipulation 白加
  • 轮播组件内部用了 touch-action: none 防止滑动冲突,结果把子按钮的点击响应也锁死了
  • 用 Chrome DevTools 的「Rendering」面板勾选 Highlight touch actions,能一眼看出哪块区域实际生效的是哪个值

作用于 body/html 标签在 iOS Safari 16.4 之前无效

iOS Safari 明确不支持在 或 上设置 touch-action。哪怕写了 body { touch-action: pan-y; },浏览器也当没看见 —— computed 样式里该属性会显示为灰色禁用状态。

必须把样式移到实际滚动容器上,比如一个带 overflow-y: auto 的 <div class="scroll-container">,并确保: <ul> <li>容器内容真实溢出(<code>scrollHeight > clientHeight),否则 touch-action 不会被激活

  • 逐级向上检查父元素的 computed touch-action 值,避免某层父级设了 pan-x 或 none 截断触摸流
  • 轮播图、弹窗遮罩层等常自带 touch-action: pan-x,它们很可能包裹了你的滚动区域
  • Android WebView 中 touch-action 被忽略的典型原因

    不少 Android App 内嵌 WebView(尤其旧版 X5 内核、系统 WebView ≤ Android 8.1)根本不解析 touch-action,哪怕写了也当没写。这时延迟不会消失,manipulation 形同虚设。

    此时只能靠 JS 兜底:

    • 监听 document.documentElement 的 gesturestart 和 touchstart 事件
    • 当 event.touches.length > 1 时调用 event.preventDefault()(注意传 { passive: false })
    • 双击缩放需缓存时间戳,拦截间隔 ≤ 300ms 的第二次 touchend
    真正容易被忽略的是:即使所有 CSS 都写对了,只要页面内容高度超出视口(比如未设 html, body { height: 100vh; }),iOS Safari 就会自动启用双指缩放查看溢出区 —— 此时 touch-action 也救不了。

    前端入门到VUE实战笔记:立即使用
    在学习笔记中,你将探索 前端 的入门与实战技巧!

    相关文章

    PHP速学视频免费教程(入门到精通)
    PHP速学视频免费教程(入门到精通)

    PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

    下载

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

    相关专题

    更多
    css
    css

    css是层叠样式表,用来表现HTML或XML等文件样式的计算机语言,不仅可以静态地修饰网页,还可以配合各种脚本语言动态地对网页各元素进行格式化。php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

    2023.06.15

    3876

    6

    css居中
    css居中

    css居中:1、通过“margin: 0 auto; text-align: center”实现水平居中;2、通过“display:flex”实现水平居中;3、通过“display:table-cell”和“margin-left”实现居中。本专题为大家提供css居中的相关的文章、下载、课程内容,供大家免费下载体验。

    2023.07.27

    877

    5

    css如何插入图片
    css如何插入图片

    cssCSS是层叠样式表(Cascading Style Sheets)的缩写。它是一种用于描述网页或应用程序外观和样式的标记语言。CSS可以控制网页的字体、颜色、布局、大小、背景、边框等方面,使得网页的外观更加美观和易于阅读。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

    2023.07.28

    1718

    6

    css超出显示...
    css超出显示...

    在CSS中,当文本内容超出容器的宽度或高度时,可以使用省略号来表示被隐藏的文本内容。本专题为大家提供css超出显示...的相关文章,相关教程,供大家免费体验。

    2023.08.01

    3106

    7

    css字体颜色
    css字体颜色

    CSS中,字体颜色可以通过属性color来设置,用于控制文本的前景色,字体颜色在网页设计中起到很重要的作用,具有以下表现作用:1、提升可读性;2、强调重点信息;3、营造氛围和美感;4、用于呈现品牌标识或与品牌形象相符的风格。

    2023.08.10

    6065

    11

    什么是css
    什么是css

    CSS是层叠样式表(Cascading Style Sheets)的缩写,是一种用于描述网页(或其他基于 XML 的文档)样式与布局的标记语言,CSS的作用和意义如下:1、分离样式和内容;2、页面加载速度优化;3、实现响应式设计;4、确保整个网站的风格和样式保持统一。

    2023.08.10

    5171

    7

    css三角形怎么写
    css三角形怎么写

    CSS可以通过多种方式实现三角形形状,本专题为大家提供css三角形怎么写的相关教程,大家可以免费体验。

    2023.08.21

    1797

    9

    css设置文字颜色
    css设置文字颜色

    CSS(层叠样式表)可以用于设置文字颜色,这样做有以下好处和优势:1、增加网页的可视化效果;2、突出显示某些重要的信息或关键字;3、增强品牌识别度;4、提高网页的可访问性;5、引起不同的情感共鸣。

    2023.08.22

    2451

    5

    css禁止点击事件
    css禁止点击事件

    实现css禁止点击事件的方法有使用CSS的pointer-events属性和使用JavaScript禁用点击事件。本专题为大家提供点击事件相关的文章、下载、课程内容,供大家免费下载体验。

    2023.08.23

    2093

    5

    热门下载

    更多
    网站特效
    /
    网站源码
    /
    网站素材
    /
    前端模板

    精品课程

    更多
    相关推荐
    /
    热门推荐
    /
    最新课程
    Sass 教程
    Sass 教程

    共14课时 | 1.5万人学习

    Bootstrap 5教程
    Bootstrap 5教程

    共46课时 | 5.6万人学习

    CSS教程
    CSS教程

    共754课时 | 93.8万人学习