Skip to content
全部文档

filter: grayscale() ​

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

快速参考 ​

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

示例 ​

基础示例 ​

使用 grayscale 和 grayscale-75 等工具类控制应用到元素上的灰度效果程度:

grayscale-0

grayscale-25

grayscale-50

grayscale

html
<img class="grayscale-0 ..." src="/img/mountains.jpg" />
<img class="grayscale-25 ..." src="/img/mountains.jpg" />
<img class="grayscale-50 ..." src="/img/mountains.jpg" />
<img class="grayscale ..." src="/img/mountains.jpg" />

使用自定义值 ​

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

html
<img class="grayscale-[0.5] ..." />

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

html
<img class="grayscale-(--my-grayscale) ..." />

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

响应式设计 ​

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

html
<img class="grayscale md:grayscale-0 ..." />

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

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