Backdrop Grayscale

Tailwind CSS version

v2.1+

Utilities for applying backdrop grayscale filters to an element.

Default class reference

Usage

Use the backdrop-grayscale and backdrop-grayscale-0 utilities alongside the backdrop-filter utility to whether an element’s backdrop should be rendered as grayscale or in full color.

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

Responsive

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

<div class="backdrop-filter backdrop-grayscale md:backdrop-grayscale-0 ...">
  <!-- ... -->
</div>

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

Customizing

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

  // tailwind.config.js
  module.exports = {
    theme: {
+     extend: {
+       backdropGrayscale: {
+         50: '.5',
+       }
+     }
    }
  }

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

Variants

By default, only responsive variants are generated for backdrop grayscale utilities.

You can control which variants are generated for the backdrop grayscale utilities by modifying the backdropGrayscale property in the variants section of your tailwind.config.js file.

For example, this config will also generate hover and focus variants:

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

Disabling

If you don’t plan to use the backdrop grayscale utilities in your project, you can disable them entirely by setting the backdropGrayscale property to false in the corePlugins section of your config file:

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

←Backdrop Contrast Backdrop Hue Rotate→

Edit this page on GitHub