Skip to content
全部文档

filter: blur()

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

快速参考

属性
blur-xsfilter: blur(var(--blur-xs)); /* 4px */
blur-smfilter: blur(var(--blur-sm)); /* 8px */
blur-mdfilter: blur(var(--blur-md)); /* 12px */
blur-lgfilter: blur(var(--blur-lg)); /* 16px */
blur-xlfilter: blur(var(--blur-xl)); /* 24px */
blur-2xlfilter: blur(var(--blur-2xl)); /* 40px */
blur-3xlfilter: blur(var(--blur-3xl)); /* 64px */
blur-nonefilter: ;
blur-(<custom-property>)filter: blur(var(<custom-property>));
blur-[<value>]filter: blur(<value>);

示例

基础示例

使用 blur-smblur-lg 等工具类为元素添加模糊效果:

blur-none

blur-sm

blur-lg

blur-2xl

html
<!-- [!code classes:blur-none,blur-sm,blur-lg,blur-2xl] -->
<img class="blur-none" src="/img/mountains.jpg" />
<img class="blur-sm" src="/img/mountains.jpg" />
<img class="blur-lg" src="/img/mountains.jpg" />
<img class="blur-2xl" src="/img/mountains.jpg" />

使用自定义值

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

html
<img class="blur-[2px] ..." />

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

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

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

响应式设计

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

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

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

自定义主题

使用 --blur-* 主题变量来自定义项目中的模糊工具类:

css
@theme {
  --blur-2xs: 2px;
}

现在可以在标记中使用 blur-2xs 工具类:

html
<img class="blur-2xs" />

主题文档中了解更多关于自定义主题的信息。

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