z-index失效主因是元素未定位或被父级层叠上下文隔离;须设position:relative等、避免opacity

卡片重叠不是“样式没加对”,而是层叠上下文被意外截断或 z-index 失效——绝大多数情况,z-index 写了但没用,是因为元素根本没定位,或者被父容器关进了独立的“Z 轴小房间”。
为什么 z-index 写了却没效果?
核心问题就两个:position 没设,或父级创建了新层叠上下文。
-
z-index只对position: relative、absolute、fixed或sticky的元素生效;纯static元素写z-index: 999完全被忽略 - 父容器只要带
opacity: 0.99、transform: translateY(0)、will-change: transform或filter,就会创建新层叠上下文——子卡片的z-index只在它内部比大小,压不住外面的导航栏或弹窗 - Flex/Grid 容器中,子项一旦设了非
auto的z-index(哪怕没写position),也会立即触发新层叠上下文
怎么让卡片真正按预期堆叠?
必须同时满足结构、定位、数值三要素,缺一不可。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 每张卡片都要显式写
position: relative(最稳妥,不破坏文档流) -
z-index值用语义化步长:底层卡片从100开始,每上一层加10(如110、120),避免用9999这类魔数 - 视觉错位用
transform: translateY(-6px) translateX(4px),别用top/margin-top——后者会触发重排,滚动卡顿明显 - 如果卡片嵌套在某个
div里且整体浮起,检查那个div是否有opacity 或transform;有就删掉,或把卡片 DOM 搬到document.body下直接挂载
响应式下卡片顺序乱了怎么办?
小屏单列时,若仍沿用桌面端的 z-index 和 transform,上层卡片可能反被下层挡住——这不是 bug,是层叠上下文在断点切换后重新计算的结果。
- 媒体查询里要同步重置
z-index和transform值,比如移动端统一设z-index: auto+transform: none,靠 DOM 顺序自然堆叠 - 避免在响应式规则里给父容器加
transform或opacity,否则子卡片的层级逻辑会彻底失效 - 用 Chrome DevTools 的 Layers 面板勾选 “Show layer borders”,一眼就能看出哪些元素被划进了孤立层叠上下文
真正难调的不是数字大小,而是哪一层被谁“封印”了——DOM 结构看着父子嵌套,Z 轴上可能隔着好几道墙。查不到根因时,先删掉所有 transform 和 opacity,再逐个加回去看哪一行让层级崩了。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










