Just-in-Time: The Next Generation of Tailwind CSS
Tailwind CSS on GitHub

Backdrop Brightness

Tailwind CSS version
v2.1+

Utilities for applying backdrop brightness filters to an element.

Default class reference

Class
Properties
backdrop-brightness-0--tw-backdrop-brightness: brightness(0);
backdrop-brightness-50--tw-backdrop-brightness: brightness(.5);
backdrop-brightness-75--tw-backdrop-brightness: brightness(.75);
backdrop-brightness-90--tw-backdrop-brightness: brightness(.9);
backdrop-brightness-95--tw-backdrop-brightness: brightness(.95);
backdrop-brightness-100--tw-backdrop-brightness: brightness(1);
backdrop-brightness-105--tw-backdrop-brightness: brightness(1.05);
backdrop-brightness-110--tw-backdrop-brightness: brightness(1.1);
backdrop-brightness-125--tw-backdrop-brightness: brightness(1.25);
backdrop-brightness-150--tw-backdrop-brightness: brightness(1.5);
backdrop-brightness-200--tw-backdrop-brightness: brightness(2);

Usage

Use the backdrop-brightness-{amount?} utilities alongside the backdrop-filter utility to control an element’s backdrop brightness.

<div class="backdrop-filter backdrop-brightness-125 ...">
  <!-- ... -->
</div>

Responsive

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

<div class="backdrop-filter backdrop-brightness-110 md:backdrop-brightness-150 ...">
  <!-- ... -->
</div>

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

Customizing

You can customize which backdrop-brightness utilities are generated using the backdropBrightness key in the theme section of your tailwind.config.js file.

  // tailwind.config.js
  module.exports = {
    theme: {
+     extend: {
+       backdropBrightness: {
+         25: '.25',
+         175: '1.75',
+       }
+     }
    }
  }

Learn more about customizing the default theme in the theme customization documentation.

Variants

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

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

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

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

Disabling

如果您不打算在您的项目中使用 backdrop brightness 功能,您可以通过在配置文件的 corePlugins 部分将 backdropBrightness 属性设置为 false 来完全禁用它们:

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