遮罩层被视频控件穿透的根本原因是其独立合成层与事件捕获机制导致z-index失效；应优先用pointer-events: none让遮罩透传事件，关键子元素设pointer-events: auto；若需完全拦截，则移除controls并自建UI。
遮罩层被视频控件（比如<video>的原生播放器、全屏按钮、进度条等）“穿透”，本质是视频控件的内部 UI 层级高于你的 CSS 遮罩层，或浏览器对媒体控件的事件捕获做了特殊处理。单纯调高 z-index 常常无效，关键要配合 pointer-events 控制事件流向。
确认遮罩层和视频的层级关系
视频元素（尤其是启用了 controls 的）在部分浏览器（如 Chrome、Edge）中，其控件是独立渲染的合成层（composited layer），可能脱离普通 DOM 层叠上下文。即使你的遮罩 z-index: 9999，控件仍能响应点击——这不是 z-index 失效，而是它根本不在同一事件捕获路径上。
- 检查视频是否设置了
playsinline或webkit-playsinline（iOS Safari 中影响内联播放行为） - 确认遮罩和视频是否同属一个 stacking context；若视频父容器有
transform、opacity < 1、will-change等，可能创建新层叠上下文，导致 z-index 比较失效 - 用浏览器开发者工具的「Layers」面板查看实际渲染层，观察视频控件是否在更高 GPU 层
用 pointer-events: none + 子元素拦截实现“穿透式遮罩”
如果目标只是「显示遮罩但允许用户操作视频控件」，正确做法不是阻止穿透，而是让遮罩本身不抢事件，再在需要拦截的位置（比如关闭按钮、自定义蒙版区域）单独开启 pointer-events: auto。
- 给遮罩容器设
pointer-events: none - 给遮罩内的可交互子元素（如 × 关闭按钮、文字提示、自定义控制栏）设
pointer-events: auto - 确保这些子元素的
z-index足够高，并处于同一层叠上下文内
这样视频控件自然响应，而你的按钮依然可用——逻辑更清晰，体验也更符合预期。
一项面向腾讯 EdgeOne（边缘安全与加速平台）的综合能力，涵盖边缘加速（DNS、证书、缓存、规则引擎、L4 代理、负载均衡）、边缘安全（DDoS 防护、Web 防护、Bot 管理）、边缘媒体（实时音视频/图像处理）、边缘开发（Edge Functions、EdgeOne Pages）等多方面功能。当用户提及任何与 EdgeOne / EO 相关的配置、运维、查询或故障排查需求时，请启用此项能力。
立即学习“前端免费学习笔记（深入）”；
彻底阻断穿透：隐藏原生控件 + 自建 UI
若必须完全禁用视频所有原生交互（包括点击播放/暂停、拖动进度条），唯一可靠方式是移除 controls 属性，用 JS + 自定义 DOM 元素实现控制逻辑，并将遮罩 z-index 提升到足够高（同时确保无其他层叠干扰）。
- 移除
<video controls>中的controls属性 - 用
<div class="custom-controls">实现播放/暂停、音量、进度条等 - 遮罩层设置
position: fixed; top: 0; left: 0; width: 100%; height: 100%; z-index: 10000; pointer-events: auto; - 确保遮罩与 video 同级或包裹它们，且父容器未创建意外的 stacking context
兼容性小技巧：iOS Safari 特别处理
iOS Safari 对 <video> 有更强的系统级接管，即使隐藏了 controls，全屏按钮仍可能出现。此时可：
- 添加
webkit-playsinline playsinline强制内联播放 - 用
video::-webkit-media-controls等伪元素隐藏控件（仅限 WebKit，效果有限） - 监听
webkitbeginfullscreen事件，在触发时主动隐藏遮罩或暂停交互 - 终极方案：用
<canvas>渲染视频帧（需 MediaSource 或 WebGL），完全脱离原生 video 标签
基本上就这些。核心不是死磕 z-index，而是理解浏览器如何处理媒体控件的渲染与事件——该让路时用 pointer-events，该接管时就放弃原生控件。不复杂但容易忽略。
