Skip to content
全部文档

z-index

用于控制元素层叠顺序的工具类。

快速参考

属性
z-<number>z-index: <number>;
z-autoz-index: auto;
z-[<value>]z-index: <value>;
z-(<custom-property>)z-index: var(<custom-property>);

示例

基础示例

使用 z-<number> 等工具类(如 z-10z-50)控制元素的层叠顺序(或三维定位),与其在文档中的显示顺序无关:

05
04
03
02
01
html
<!-- [!code classes:z-40,z-30,z-20,z-10,z-0] -->
<div class="z-40 ...">05</div>
<div class="z-30 ...">04</div>
<div class="z-20 ...">03</div>
<div class="z-10 ...">02</div>
<div class="z-0 ...">01</div>

使用负值

要使用负的 z-index 值,在类名前面加上短横线即可转换为负值:

01
02
03
04
05
html
<!-- [!code classes:-z-10] -->
<div class="...">05</div>
<div class="...">04</div>
<div class="-z-10 ...">03</div>
<div class="...">02</div>
<div class="...">01</div>

使用自定义值

使用 z-[<value>] 等工具类,根据完全自定义的值设置层叠顺序:

html
<div class="z-[calc(var(--index)+1)] ...">
 <!-- ... -->
</div>

对于 CSS 变量,也可以使用 z-(<custom-property>) 语法:

html
<div class="z-(--my-z) ...">
 <!-- ... -->
</div>

这只是 z-[var(<custom-property>)] 的简写,会自动为你加上 var() 函数。

响应式设计

使用 md: 等断点变体作为 z-index 工具类的前缀,即可仅在中等及以上屏幕尺寸下应用该工具类:

html
<div class="z-0 md:z-50 ...">
 <!-- ... -->
</div>

了解如何使用变体,请参阅变体文档

文档译文以 MIT 协议授权;原文版权归 Tailwind Labs。湘ICP备2026005453号-2