video元素z-index无效因其是替换元素且在旧版Chrome/Safari中创建独立层叠上下文；须设父容器position:relative/absolute并显式设置video自身position，避免transform或will-change触发合成层。

video 元素的 z-index 为什么无效

因为 <video></video> 默认是 replaced element（替换元素），在某些浏览器（尤其是旧版 Chrome 和 Safari）中会创建独立的层叠上下文，导致直接设置 z-index 不起作用——哪怕父容器已设 position: relative。

常见错误现象：z-index: -1 想把视频藏到其他元素后面，结果视频仍盖在最上层；或用 transform: translateZ(0) 强制提升层叠上下文后，反而让遮罩层失效。

• 必须给 <video></video> 的父容器设置 position: relative 或 absolute，且该容器不能是 直接子元素（否则部分浏览器仍绕过层叠控制）
• 视频自身需显式设置 position: absolute 或 relative，否则 z-index 被忽略
• 避免对 <video></video> 同时使用 will-change: transform 或 transform: translateZ(0)，这会触发合成层，使其脱离普通文档流层叠顺序

用 poster + transparent overlay 实现“视觉隐藏”

当真正需要“隐藏但保留占位和可交互性”（比如点击播放、监听 timeupdate），不推荐 display: none 或 visibility: hidden ——它们会让视频暂停、丢失当前时间点、甚至中断媒体资源加载。

更稳妥的做法是用视觉遮蔽而非 DOM 隐藏：

立即学习“前端免费学习笔记（深入）”；

使用华数设计生成高保真HTML原型、演示文稿、动画和设计评审

使用经过文档化的设计技能，从真实的品牌或项目背景中生成HTML原生原型、幻灯片、动态演示、可视化图表和评审流程。

下载

• 设置 poster 属性为一张纯透明 PNG（1×1 像素，base64 编码： data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=）
• 叠加一层 position: absolute 的空 <div>，背景设为 <code>transparent，并确保其 z-index 高于 video 自身
• 若需响应点击，保留 <video></video> 的 controls 属性或手动绑定 onclick，不要依赖 overlay 拦截事件（否则移动端可能触发双击缩放）

iframe 嵌入 YouTube/Vimeo 时的层叠陷阱

第三方视频 iframe 默认具有最高层叠优先级（尤其在 iOS Safari 中），z-index 几乎无效。这不是 bug，而是浏览器对嵌入式插件内容的安全限制。

可行解法有限，优先级从高到低：

• 添加 ?wmode=opaque 查询参数（仅对旧版 Flash YouTube 有效，现已基本弃用）
• 对 YouTube iframe 使用 allow="accelerometer; gyroscope; picture-in-picture" 并配合 allowfullscreen，部分新版 Chrome 可恢复层叠控制
• 最可靠方式：用 pointer-events: none 在 overlay 上透传点击，再用 JS 监听 overlay 的 click，手动调用 iframe 的 contentWindow.postMessage(...) 控制播放（需目标 iframe 支持 postMessage API）

移动端全屏退出后的定位错乱

iOS Safari 和部分 Android 浏览器在退出 <video></video> 全屏后，会重置其 CSS 渲染状态，导致原本靠 position: absolute 精确定位的视频突然“跳回文档流顶部”或尺寸归零。

关键应对点：

• 监听 webkitendfullscreen（iOS）和 fullscreenchange（Android/Chrome）事件，在回调中强制重设 top/left 和 width/height
• 避免用 % 或 vh 单位做 video 容器定位，改用 px 或 rem 配合 JS 动态计算（因全屏退出后视口尺寸可能未及时刷新）
• 不要依赖 video.offsetHeight 立即取值——需在 setTimeout(..., 0) 或 requestAnimationFrame 中延迟读取，否则拿到的是全屏前旧值
实际排版中，最易被忽略的是：视频是否启用 playsinline 属性。没加它，iOS 上点播放就强跳全屏，后续所有层叠控制都失去意义。