Skip to content
全部文档

filter

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

快速参考

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

示例

基础示例

使用 blur-xsgrayscale 等工具类为元素应用滤镜:

blur-xs

grayscale

combined

html
<!-- [!code classes:blur-xs,grayscale] -->
<img class="blur-xs" src="/img/mountains.jpg" />
<img class="grayscale" src="/img/mountains.jpg" />
<img class="blur-xs grayscale" src="/img/mountains.jpg" />

你可以组合使用以下滤镜工具类:blurbrightnesscontrastdrop-shadowgrayscalehue-rotateinvertsaturatesepia

移除滤镜

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

html
<!-- [!code classes:md:filter-none] -->
<img class="blur-md brightness-150 invert md:filter-none" src="/img/mountains.jpg" />

使用自定义值

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

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

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

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

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

悬停时应用

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

html
<img class="blur-sm hover:filter-none ..." />

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

响应式设计

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

html
<img class="blur-sm md:filter-none ..." />

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

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