Backdrop Saturate

Tailwind CSS version

v2.1+

Utilities for applying backdrop saturation filters to an element.

Default class reference

Class
Properties
backdrop-saturate-0—tw-backdrop-saturate: saturate(0);
backdrop-saturate-50—tw-backdrop-saturate: saturate(.5);
backdrop-saturate-100—tw-backdrop-saturate: saturate(1);
backdrop-saturate-150—tw-backdrop-saturate: saturate(1.5);
backdrop-saturate-200—tw-backdrop-saturate: saturate(2);

Usage

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

  1. <div class="backdrop-filter backdrop-saturate-125 ...">
  2. <!-- ... -->
  3. </div>

Responsive

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

  1. <div class="backdrop-filter backdrop-saturate-110 md:backdrop-saturate-150 ...">
  2. <!-- ... -->
  3. </div>

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

Customizing

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

  1. // tailwind.config.js
  2. module.exports = {
  3. theme: {
  4. + extend: {
  5. + backdropSaturate: {
  6. + 25: '.25',
  7. + }
  8. + }
  9. }
  10. }

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

Variants

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

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

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

  1. // tailwind.config.js
  2. module.exports = {
  3. variants: {
  4. extend: {
  5. // ...
  6. + backdropSaturate: ['hover', 'focus'],
  7. }
  8. }
  9. }

Disabling

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

  1. // tailwind.config.js
  2. module.exports = {
  3. corePlugins: {
  4. // ...
  5. + backdropSaturate: false,
  6. }
  7. }

←Backdrop Opacity Backdrop Sepia→

Edit this page on GitHub