Skip to content
全部文档

backdrop-filter: grayscale()

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

快速参考

属性
backdrop-grayscalebackdrop-filter: grayscale(100%);
backdrop-grayscale-<number>backdrop-filter: grayscale(<number>%);
backdrop-grayscale-(<custom-property>)backdrop-filter: grayscale(var(<custom-property>));
backdrop-grayscale-[<value>]backdrop-filter: grayscale(<value>);

示例

基础示例

使用 backdrop-grayscale-50backdrop-grayscale 等工具类控制应用到元素背景上的灰度效果:

backdrop-grayscale-0

backdrop-grayscale-50

backdrop-grayscale

html
<!-- [!code classes:backdrop-grayscale-0,backdrop-grayscale-50,backdrop-grayscale] -->
<div class="bg-[url(/img/mountains.jpg)]">
  <div class="bg-white/30 backdrop-grayscale-0 ..."></div>
</div>
<div class="bg-[url(/img/mountains.jpg)]">
  <div class="bg-white/30 backdrop-grayscale-50 ..."></div>
</div>
<div class="bg-[url(/img/mountains.jpg)]">
  <div class="bg-white/30 backdrop-grayscale-200 ..."></div>
</div>

使用自定义值

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

html
<div class="backdrop-grayscale-[0.5] ...">
 <!-- ... -->
</div>

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

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

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

响应式设计

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

html
<div class="backdrop-grayscale md:backdrop-grayscale-0 ...">
 <!-- ... -->
</div>

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

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