Safari中touch-action不生效的三大硬性条件：必须作用于overflow-auto的非根元素、内容真实溢出、祖先节点无更严格touch-action声明；Android WebView中manipulation失效常见于缺role/button语义、父级none压制或viewport缺失。
touch-action 不是“写了就生效”的开关，它在不同浏览器中生效的前提、限制和优先级差异极大——尤其在 Safari 和旧版 Android WebView 中，写错一层、漏查一个父级，整个手势链就断了。
touch-action 在 Safari 中不生效的三大硬性条件
Safari（iOS 16.4+）只在满足全部以下条件时才真正启用 touch-action：
- 作用目标必须是
overflow-y: auto或overflow-x: auto的**非根元素**（body和html上设置直接被忽略） - 该容器内容必须真实溢出（
scrollHeight > clientHeight），仅设overflow不够 - 从该元素到
body的所有祖先节点，都不能有更严格的touch-action声明（例如父级是pan-x，子级设pan-y就会被截断）
真机调试时务必打开 Safari 开发者工具 → Elements → Computed 面板，逐级检查 touch-action 的最终计算值是否为预期值，而不是灰色禁用状态。
Android WebView 中 touch-action: manipulation 失效的典型场景
Chrome 115+ 及部分定制 WebView 对 touch-action: manipulation 的语义校验更严格，常见失效点：
立即学习“前端免费学习笔记（深入）”；
- 加在
div上但没配role="button"或tabindex="0"—— iOS 和新版 Android 都要求“可点击身份”，纯样式声明无效 - 父容器设置了
touch-action: none（如某些弹窗组件、轮播图 wrapper），子元素即使显式写manipulation也会被压制 - viewport meta 缺失或位置错误：
<meta name="viewport" content="width=device-width, initial-scale=1.0">必须在最顶部，否则浏览器退回双击检测逻辑，touch-action形同虚设
验证方式：DevTools 的 Computed 面板里看 touchAction 是否为 manipulation，不是则说明被覆盖或未识别。
多点触控（如双指缩放）被拦截的根本原因与解法
Interact.js、Fabric.js 等库绑定拖拽后，双指缩放失效，不是 JS 库的问题，而是浏览器默认行为：
-
interact(target).draggable(true)会自动加touch-action: none，这直接禁用了所有多点触控序列 - 若需单指拖拽 + 双指缩放，必须显式改用
touch-action: pinch-zoom，并调用.gesturable({ onmove }) - 不能同时开启
.draggable(true)和.gesturable(true)，事件竞争会导致缩放卡顿或无响应
正确写法示例：
element.style.touchAction = 'pinch-zoom';<br>interact(element).gesturable({ onmove: handlePinch }).draggable(false);注意：handlePinch 中应基于 event.scale 手动更新尺寸，而非依赖 resize()。
滚动容器与下拉刷新的手势分流陷阱
给主内容区设 touch-action: pan-y 本意是允许纵向滚动，却导致下拉刷新监听收不到 touchmove，问题出在事件分发路径被提前截断：
-
pan-y允许浏览器接管纵向滚动，但同时也把所有纵向位移都导向了原生滚动引擎，你的 JS 监听器可能根本收不到事件 - 解决思路不是去掉
pan-y，而是在顶部区域（如header）单独设touch-action: none，确保下拉触发区保有完整事件流 - 配合
overscroll-behavior-y: contain控制滚动到底部时是否触发全局刷新，避免和 Chrome 的导航下拉冲突
最易被忽略的一点：position: fixed 的 header 若未设 pointer-events: none，可能意外捕获 touchstart，导致事件无法冒泡到下拉监听器。
