Tailwind CSS on GitHub

Backdrop Blur

Tailwind CSS version

Utilities for applying backdrop blur filters to an element.

Default class reference

backdrop-blur-0--tw-backdrop-blur: blur(0);
backdrop-blur-sm--tw-backdrop-blur: blur(4px);
backdrop-blur--tw-backdrop-blur: blur(8px);
backdrop-blur-md--tw-backdrop-blur: blur(12px);
backdrop-blur-lg--tw-backdrop-blur: blur(16px);
backdrop-blur-xl--tw-backdrop-blur: blur(24px);
backdrop-blur-2xl--tw-backdrop-blur: blur(40px);
backdrop-blur-3xl--tw-backdrop-blur: blur(64px);


Use the backdrop-blur-{amount?} utilities alongside the backdrop-filter utility to blur an element.

<div class="backdrop-filter backdrop-blur-lg ...">
  <!-- ... -->


To control an element's backdrop blur at a specific breakpoint, add a {screen}: prefix to any existing backdrop blur utility. For example, use md:backdrop-blur-lg to apply the backdrop-blur-lg utility at only medium screen sizes and above.

<div class="backdrop-filter backdrop-blur-sm md:backdrop-blur-lg ...">
  <!-- ... -->

For more information about Tailwind's responsive design features, check out the Responsive Design documentation.



默认情况下, 针对 backdrop blur 功能类,只生成 responsive 变体。

您可以通过修改您的 tailwind.config.js 文件中的 variants 部分中的 backdropBlur 属性来控制为 backdrop blur 功能生成哪些变体。

例如,这个配置将生成 hover and focus 变体:

  // tailwind.config.js
  module.exports = {
    variants: {
      extend: {
        // ...
+       backdropBlur: ['hover', 'focus'],


如果您不打算在您的项目中使用 backdrop blur 功能,您可以通过在配置文件的 corePlugins 部分将 backdropBlur property to false in the corePlugins section of your config file:

  // tailwind.config.js
  module.exports = {
    corePlugins: {
      // ...
+     backdropBlur: false,