层叠上下文（Stacking Context）· 码译

明明 z-index 很大却还是被盖

层叠上下文

Stacking Context

反模式在不懂层叠规则时乱调 z-index，越调越乱

正解理解：z-index 只在同一个层叠上下文里比大小；新上下文会隔离比较

在线对比体验 · 同一个需求，大白话 vs 平台提示词，效果立分高下 · 右边可点击体验

大白话直接生成

父级新上下文隔离比较

平台提示词生成

理清上下文再调层级

点一下试试

差在哪？大白话没讲「在不懂层叠规则时乱调 z-index，越调越乱」，AI 只能自己猜；平台提示词写明「理解：z-index 只在同一个层叠上下文里比大小；新上下文会隔离比较」，还带要点与三端注意，一次到位不用返工。

代码示例

错误写法

/* 父级有 transform/opacity 形成新上下文，子级 z-index 再大也出不去 */

正确写法

/* 规则：同上下文比 z-index；创建上下文的属性：transform/opacity/filter/position+z-index */

语义锚点 · 对齐 AI 语义库契约

<div data-vibe="stacking-context"> … 组件根元素 … </div><!-- AI 用语义名片 locate 此属性即可定位/修改 -->

在组件根元素挂 data-vibe="stacking-context"，AI 用语义名片里的 locate（[data-vibe='stacking-context']）即可定位、修改、组合该组件——与「AI 语义库」tab 的契约一一对应。在 AI 语义库看契约 →

不同平台注意

网页层叠规则通用

AppRN 无此概念，靠组件顺序

小程序wxss 同 web，但要注意原生组件

可直接复制的提示词（三端都给你，挑对应平台复制给 Cursor / 通义灵码 / Claude）

网页 Web

你是一位资深前端工程师。我想实现【层叠上下文】（专业术语：Stacking Context）。

【我想达到的效果】明明 z-index 很大却还是被盖。
【请避免的反模式】在不懂层叠规则时乱调 z-index，越调越乱。
【正确做法】理解：z-index 只在同一个层叠上下文里比大小；新上下文会隔离比较。

【平台】网页 Web（标准 HTML/CSS/JS，单文件零依赖，不引任何 CDN）。
【提示词要点】
- z-index 只在同一上下文内有效
- transform/opacity 会创建新上下文
- 先理清上下文再调层级

请输出完整可运行代码（关键处写中文注释），并附 50 字以内使用说明。

手机 App

你是一位资深前端工程师。我想实现【层叠上下文】（专业术语：Stacking Context）。

【我想达到的效果】明明 z-index 很大却还是被盖。
【请避免的反模式】在不懂层叠规则时乱调 z-index，越调越乱。
【正确做法】理解：z-index 只在同一个层叠上下文里比大小；新上下文会隔离比较。

【平台】手机 App（React Native / Flutter / 原生，给出对应组件与关键代码）。
【提示词要点】
- z-index 只在同一上下文内有效
- transform/opacity 会创建新上下文
- 先理清上下文再调层级

请输出完整可运行代码（关键处写中文注释），并附 50 字以内使用说明。

微信小程序

你是一位资深前端工程师。我想实现【层叠上下文】（专业术语：Stacking Context）。

【我想达到的效果】明明 z-index 很大却还是被盖。
【请避免的反模式】在不懂层叠规则时乱调 z-index，越调越乱。
【正确做法】理解：z-index 只在同一个层叠上下文里比大小；新上下文会隔离比较。

【平台】微信小程序（WXML/WXSS/JS，注意 rpx 单位与小程序专属约束）。
【提示词要点】
- z-index 只在同一上下文内有效
- transform/opacity 会创建新上下文
- 先理清上下文再调层级

请输出完整可运行代码（关键处写中文注释），并附 50 字以内使用说明。