Skip to content
全部文档

backdrop-filter: blur()

用于为元素应用背景模糊滤镜的工具类。

快速参考

属性
backdrop-blur-xsbackdrop-filter: blur(var(--blur-xs)); /* 4px */
backdrop-blur-smbackdrop-filter: blur(var(--blur-sm)); /* 8px */
backdrop-blur-mdbackdrop-filter: blur(var(--blur-md)); /* 12px */
backdrop-blur-lgbackdrop-filter: blur(var(--blur-lg)); /* 16px */
backdrop-blur-xlbackdrop-filter: blur(var(--blur-xl)); /* 24px */
backdrop-blur-2xlbackdrop-filter: blur(var(--blur-2xl)); /* 40px */
backdrop-blur-3xlbackdrop-filter: blur(var(--blur-3xl)); /* 64px */
backdrop-blur-nonebackdrop-filter: ;
backdrop-blur-(<custom-property>)backdrop-filter: blur(var(<custom-property>));
backdrop-blur-[<value>]backdrop-filter: blur(<value>);

示例

基础示例

使用 backdrop-blur-smbackdrop-blur-lg 等工具类控制元素的背景模糊:

backdrop-blur-none

backdrop-blur-sm

backdrop-blur-md

html
<!-- [!code classes:backdrop-blur-none,backdrop-blur-sm,backdrop-blur-md] -->
<div class="bg-[url(/img/mountains.jpg)]">
  <div class="bg-white/30 backdrop-blur-none ..."></div>
</div>
<div class="bg-[url(/img/mountains.jpg)]">
  <div class="bg-white/30 backdrop-blur-sm ..."></div>
</div>
<div class="bg-[url(/img/mountains.jpg)]">
  <div class="bg-white/30 backdrop-blur-md ..."></div>
</div>

使用自定义值

使用 backdrop-blur-[<value>] 等工具类,基于完全自定义的值设置背景模糊:

html
<div class="backdrop-blur-[2px] ...">
 <!-- ... -->
</div>

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

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

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

响应式设计

使用 md: 等断点变体作为 backdrop-filter: blur() 工具类的前缀,即可仅在中等及以上屏幕尺寸时应用该工具类:

html
<div class="backdrop-blur-none md:backdrop-blur-lg ...">
 <!-- ... -->
</div>

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

自定义主题

使用 --blur-* 主题变量来自定义项目中的背景模糊工具类:

css
@theme {
  --blur-2xs: 2px;
}

现在可以在标记中使用 backdrop-blur-2xs 工具类:

html
<div class="backdrop-blur-2xs">
 <!-- ... -->
</div>

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

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