1. 效果
  2. 阴影效果

效果

阴影效果

用于控制元素阴影效果的实用工具。

类名样式
shadow-2xs
box-shadow: var(--shadow-2xs); /* 0 1px rgb(0 0 0 / 0.05) */
shadow-xs
box-shadow: var(--shadow-xs); /* 0 1px 2px 0 rgb(0 0 0 / 0.05) */
shadow-sm
box-shadow: var(--shadow-sm); /* 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1) */
shadow-md
box-shadow: var(--shadow-md); /* 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1) */
shadow-lg
box-shadow: var(--shadow-lg); /* 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1) */
shadow-xl
box-shadow: var(--shadow-xl); /* 0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1) */
shadow-2xl
box-shadow: var(--shadow-2xl); /* 0 25px 50px -12px rgb(0 0 0 / 0.25) */
shadow-none
box-shadow: 0 0 #0000;
shadow-(<custom-property>)
box-shadow: var(<custom-property>);
shadow-(color:<custom-property>)
--tw-shadow-color: var(<custom-property>);

示例

基本示例

使用类似 shadow-smshadow-lg 这样的工具类,将不同尺寸的外部盒阴影应用到元素。

shadow-md

shadow-lg

shadow-xl

<div class="shadow-md ..."></div>
<div class="shadow-lg ..."></div>
<div class="shadow-xl ..."></div>

更改不透明度

使用不透明度修饰符来调整盒阴影的不透明度。

shadow-xl

shadow-xl/20

shadow-xl/30

<div class="shadow-xl ..."></div>
<div class="shadow-xl/20 ..."></div>
<div class="shadow-xl/30 ..."></div>

默认的盒阴影不透明度相当低(25% 或更低),因此增加不透明度(例如到 50%)会使盒阴影更加明显。

设置阴影颜色

使用类似 shadow-indigo-500shadow-cyan-500/50 这样的工具类来更改盒阴影的颜色。

shadow-cyan-500/50

shadow-blue-500/50

shadow-indigo-500/50

<button class="bg-cyan-500 shadow-lg shadow-cyan-500/50 ...">Subscribe</button>
<button class="bg-blue-500 shadow-lg shadow-blue-500/50 ...">Subscribe</button>
<button class="bg-indigo-500 shadow-lg shadow-indigo-500/50 ...">Subscribe</button>

默认情况下,彩色阴影的不透明度为 100%,但您可以使用不透明度修饰符来调整它。

添加内阴影

使用类似 inset-shadow-xsinset-shadow-sm 这样的工具类,将内盒阴影应用到元素。

inset-shadow-2xs

inset-shadow-xs

inset-shadow-sm

<div class="inset-shadow-2xs ..."></div>
<div class="inset-shadow-xs ..."></div>
<div class="inset-shadow-sm ..."></div>

您可以使用不透明度修饰符来调整内阴影的不透明度,例如 inset-shadow-sm/50。默认的内阴影不透明度非常低(5%),因此增加不透明度(例如到 50%)会使内阴影更加明显。

设置内阴影颜色

使用类似 inset-shadow-indigo-500inset-shadow-cyan-500/50 这样的工具类来更改内盒阴影的颜色。

inset-shadow-indigo-500

inset-shadow-indigo-500/50

<div class="inset-shadow-sm inset-shadow-indigo-500 ..."></div>
<div class="inset-shadow-sm inset-shadow-indigo-500/50 ..."></div>

默认情况下,彩色阴影的不透明度为 100%,但您可以使用不透明度修饰符来调整它。

添加描边

使用 ringring-<number> 工具类,例如 ring-2ring-4,将实线盒阴影应用到元素。

ring-2

ring-4

<button class="ring ...">Subscribe</button>
<button class="ring-2 ...">Subscribe</button>
<button class="ring-4 ...">Subscribe</button>

默认情况下,描边会匹配应用它们的元素的 currentColor

设置描边颜色

使用类似 ring-indigo-500ring-cyan-500/50 这样的工具类来更改描边的颜色。

环-蓝色-500

ring-blue-500/50

<button class="ring-2 ring-blue-500 ...">Subscribe</button>
<button class="ring-2 ring-blue-500/50 ...">Subscribe</button>

默认情况下,描边的不透明度为 100%,但您可以使用不透明度修饰符来调整它。

添加内描边

使用 inset-ringinset-ring-<number> 工具类,例如 inset-ring-2inset-ring-4,将实线内盒阴影应用到元素。

内嵌环形

inset-ring-2

inset-ring-4

<button class="inset-ring ...">Subscribe</button>
<button class="inset-ring-2 ...">Subscribe</button>
<button class="inset-ring-4 ...">Subscribe</button>

默认情况下,内描边会匹配应用它们的元素的 currentColor

设置内描边颜色

使用类似 inset-ring-indigo-500inset-ring-cyan-500/50 这样的工具类来更改内描边的颜色。

内嵌环形-蓝色-500

inset-ring-blue-500/50

<button class="inset-ring-2 inset-ring-blue-500 ...">Subscribe</button>
<button class="inset-ring-2 inset-ring-blue-500/50 ...">Subscribe</button>

默认情况下,内描边的不透明度为 100%,但您可以使用不透明度修饰符来调整它。

移除盒阴影

使用 shadow-noneinset-shadow-nonering-0inset-ring-0 工具类来移除元素上已有的盒阴影。

shadow-none

<div class="shadow-none ..."></div>

使用自定义值

使用类似这样的工具类: shadow-[<value>]inset-shadow-[<value>]ring-[<value>]inset-ring-[<value>]来设置盒阴影基于完全自定义的值

<div class="shadow-[0_35px_35px_rgba(0,0,0,0.25)] ...">
<!-- ... -->
</div>

对于 CSS 变量,您还可以使用 shadow-(<custom-property>) 语法

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

这只是 shadow-[var(<custom-property>)] 的简写形式,它会自动为您添加 var() 函数。

响应式设计

前缀一个 box-shadow 工具类 带有断点变体,例如 md:,以仅在中等中等 屏幕尺寸及以上尺寸应用该工具类。

<div class="shadow-none md:shadow-lg ...">
<!-- ... -->
</div>

变体文档中了解更多关于使用变体的信息。

自定义您的主题

自定义阴影

使用 --shadow-* 主题变量来自定义您项目中的盒阴影 工具类

@theme {
--shadow-3xl: 0 35px 35px rgba(0, 0, 0, 0.25);
}

现在 shadow-3xl 工具类可以在您的标记中使用。

<div class="shadow-3xl">
<!-- ... -->
</div>

主题文档

中了解更多关于自定义主题的信息。 theme documentation.

自定义内阴影

使用 --inset-shadow-* 主题变量来自定义内盒阴影 工具类

@theme {
--inset-shadow-md: inset 0 2px 3px rgba(0, 0, 0, 0.25);
}

现在 inset-shadow-md 工具类可以在您的标记中使用。

<div class="inset-shadow-md">
<!-- ... -->
</div>

主题文档

中了解更多关于自定义主题的信息。 theme documentation.

自定义阴影颜色

使用 --color-* 主题变量来自定义color 工具类

@theme {
--color-regal-blue: #243c5a;
}

现在像这样的工具类: shadow-regal-blueinset-shadow-regal-bluering-regal-blueinset-ring-regal-blue可以在您的标记中使用。

<div class="shadow-regal-blue">
<!-- ... -->
</div>

主题文档

中了解更多关于自定义主题的信息。 theme documentation.

版权所有 © 2025 Tailwind Labs Inc.·商标政策