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>);

示例

基础示例

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

grayscale-0

grayscale-25

grayscale-50

grayscale

html
<!-- [!code classes:grayscale-0,grayscale-25,grayscale-50,grayscale] -->
<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