快速参考

属性
shadow-smbox-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05);
shadowbox-shadow: 0 1px 3px 0 rgb(0 0 0 / 0.1), 0 1px 2px -1px rgb(0 0 0 / 0.1);
shadow-mdbox-shadow: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);
shadow-lgbox-shadow: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
shadow-xlbox-shadow: 0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1);
shadow-2xlbox-shadow: 0 25px 50px -12px rgb(0 0 0 / 0.25);
shadow-innerbox-shadow: inset 0 2px 4px 0 rgb(0 0 0 / 0.05);
shadow-nonebox-shadow: 0 0 #0000;

基本用法

添加外部阴影

使用 `shadow-sm`、`shadow`、`shadow-md`、`shadow-lg`、`shadow-xl` 或 `shadow-2xl` 实用程序为元素应用不同大小的外部框阴影。

shadow-md

shadow-lg

shadow-xl

shadow-2xl

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

添加内阴影

使用 `shadow-inner` 实用程序为元素应用一个微妙的内嵌框阴影。这对于表单控件或井号等内容很有用。

shadow-inner

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

移除阴影

使用 `shadow-none` 从元素中移除现有的框阴影。这最常用于移除在较小断点处应用的阴影。

shadow-none

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

条件应用

悬停、聚焦和其他状态

Tailwind 允许你使用变体修饰符在不同状态下有条件地应用实用程序类。例如,使用 `hover:shadow-lg` 仅在悬停时应用 `shadow-lg` 实用程序。

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

要查看所有可用状态修饰符的完整列表,请查看 悬停、焦点和其它状态 文档。

断点和媒体查询

你也可以使用变体修饰符来定位媒体查询,例如响应式断点、暗黑模式、 prefers-reduced-motion 等等。例如,使用 `md:shadow-lg` 仅在中等屏幕尺寸及以上时应用 `shadow-lg` 实用程序。

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

要了解更多信息,请查看关于 响应式设计暗黑模式其它媒体查询修饰符 的文档。


使用自定义值

自定义主题

默认情况下,Tailwind 提供六个下拉阴影实用程序,一个内阴影实用程序,以及一个用于移除现有阴影的实用程序。你可以通过编辑 `tailwind.config.js` 文件中的 `theme.boxShadow` 或 `theme.extend.boxShadow` 来自定义这些值。

如果提供了 `DEFAULT` 阴影,它将用于无后缀的 `shadow` 实用程序。任何其他键将用作后缀,例如键 `'2'` 将创建一个相应的 `shadow-2` 实用程序。

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      boxShadow: {
        '3xl': '0 35px 60px -15px rgba(0, 0, 0, 0.3)',
      }
    }
  }
}

主题自定义 文档中了解更多关于自定义默认主题的信息。

任意值

如果您需要使用一个不适合包含在主题中的 box-shadow 值,请使用方括号使用任何任意值动态生成属性。

<div class="shadow-[0_35px_60px_-15px_rgba(0,0,0,0.3)]">
  <!-- ... -->
</div>

任意值 文档中了解更多关于任意值支持的信息。