给按钮加 touch-action: manipulation 最有效，因其跳过双击判断流程，消除300ms延迟并阻止双击缩放，且为W3C标准行为，须作用于按钮或其父容器而非全局。
为什么给按钮加 touch-action: manipulation 最有效
双击放大本质是浏览器在两次快速 touchend 后触发的缩放逻辑，而 touch-action: manipulation 会直接跳过双击判断流程——它告诉浏览器“这个元素只响应点击和滚动，别等第二次 tap”，既消除了 300ms 延迟，也顺带阻止了双击缩放。这不是 hack，是 W3C 标准行为。
- 必须作用于按钮本身或其父容器，
body或html上设无效 - 写法示例：
button, .btn-primary { touch-action: manipulation; } - 避免全局写
* { touch-action: manipulation; }，否则轮播图、地图拖拽全失效 - 若父级已设
touch-action: none，子元素的manipulation会被覆盖，需检查层叠顺序
dblclick 事件监听器绑在哪才真正生效
iOS Safari 对 dblclick 的捕获非常敏感，且只在 document.documentElement 上稳定触发。绑在 body 上常因 DOM 尚未就绪或 iframe 遮挡而漏掉；绑在具体按钮上则无法覆盖用户在按钮空白处双击的行为。
- 正确写法：
document.documentElement.addEventListener('dblclick', e => e.preventDefault(), { passive: false }); -
{ passive: false }是硬性要求，现代 iOS/Chrome 默认设为true，此时preventDefault()会被静默忽略 - 建议放在
<body>底部内联执行，或在DOMContentLoaded后立即注册 - 仅靠
dblclick不够：iOS 15+ 中快速双击后立刻捏合，可能绕过该事件，需配合其他拦截
为什么单靠 viewport meta 标签根本拦不住双击
user-scalable=no 在 iOS 10.3+ 和 Chrome 90+ 中已被系统级忽略，不是你写错了，是浏览器主动放弃执行——这是为了保障视障用户能手动放大文字。哪怕你写了 maximum-scale=1.0，只要页面内容高度超出视口（document.documentElement.scrollHeight > window.innerHeight），iOS Safari 仍会自动启用双击缩放。
- 必须写的最小集合：
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0, user-scalable=no"> - 该标签必须静态写在
<head>最早位置，JS 动态插入完全无效 -
minimum-scale=1.0有可访问性风险，实际项目中应慎用，优先保留用户手动放大的权利 - 它只是基础提示，不是禁令；真正起效靠的是 JS + CSS 组合拦截
必须同时监听 gesturestart 和 touchstart
gesturestart 是 iOS Safari 特有事件，在双指触控刚发生时就触发，比 touchstart 更早，拦截更彻底。只监听后者，容易在快速捏合时漏掉首帧，导致缩放已开始才被阻断。
立即学习“前端免费学习笔记（深入）”；
- 双指缩放拦截：
document.documentElement.addEventListener('touchstart', e => { if (e.touches.length > 1) e.preventDefault(); }, { passive: false }); - 双击源头拦截：
document.documentElement.addEventListener('gesturestart', e => e.preventDefault(), { passive: false }); - 时间戳防双击：
let lastTouchEnd = 0; document.documentElement.addEventListener('touchend', e => { const now = Date.now(); if (now - lastTouchEnd - 所有监听必须用
document.documentElement，避免被 iframe 或子容器干扰
真正不可控的部分是系统辅助功能缩放——比如 iOS「放大器」或 Android TalkBack 模式下的手势，这部分无法也不该被网页代码干预。你只能控制原生 Web 手势路径，而不能覆盖操作系统级无障碍能力。
