Skip to content
全部文档

backdrop-filter

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

快速参考

属性
backdrop-filter-nonebackdrop-filter: none;
backdrop-filter-(<custom-property>)backdrop-filter: var(<custom-property>);
backdrop-filter-[<value>]backdrop-filter: <value>;

示例

基础示例

使用 backdrop-blur-xsbackdrop-grayscale 等工具类为元素的背景应用滤镜:

backdrop-blur-xs

backdrop-grayscale

combined

html
<!-- [!code classes:backdrop-blur-xs,backdrop-grayscale] -->
<div class="bg-[url(/img/mountains.jpg)] ...">
  <div class="backdrop-blur-xs ..."></div>
</div>
<div class="bg-[url(/img/mountains.jpg)] ...">
  <div class="backdrop-grayscale ..."></div>
</div>
<div class="bg-[url(/img/mountains.jpg)] ...">
  <div class="backdrop-blur-xs backdrop-grayscale ..."></div>
</div>

你可以组合使用以下背景滤镜工具类:blurbrightnesscontrastgrayscalehue-rotateinvertopacitysaturatesepia

移除滤镜

使用 backdrop-filter-none 工具类移除应用到元素上的所有背景滤镜:

html
<!-- [!code classes:md:backdrop-filter-none] -->
<div class="backdrop-blur-md backdrop-brightness-150 md:backdrop-filter-none"></div>

使用自定义值

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

html
<div class="backdrop-filter-[url('filters.svg#filter-id')] ...">
 <!-- ... -->
</div>

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

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

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

悬停时应用

使用 hover:* 等变体作为 backdrop-filter 工具类的前缀,即可仅在该状态下应用该工具类:

html
<div class="backdrop-blur-sm hover:backdrop-filter-none ...">
 <!-- ... -->
</div>

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

响应式设计

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

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

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

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