Filters
Backdrop Saturate
Utilities for applying backdrop saturation filters to an element.
Quick reference
Class | Properties |
---|---|
backdrop-saturate-0 | backdrop-filter: saturate(0); |
backdrop-saturate-50 | backdrop-filter: saturate(.5); |
backdrop-saturate-100 | backdrop-filter: saturate(1); |
backdrop-saturate-150 | backdrop-filter: saturate(1.5); |
backdrop-saturate-200 | backdrop-filter: saturate(2); |
Basic usage
Changing backdrop saturation
Use the saturate-{amount}
utilities to control an element’s backdrop saturation.
<div class="backdrop-saturate-50 bg-white/30 ...">
<!-- ... -->
</div>
<div class="backdrop-saturate-125 bg-white/30 ...">
<!-- ... -->
</div>
<div class="backdrop-saturate-200 bg-white/30 ...">
<!-- ... -->
</div>
Removing backdrop filters
To remove all of the backdrop filters on an element at once, use the backdrop-filter-none
utility:
<div class="backdrop-blur-md backdrop-saturate-150 md:backdrop-filter-none">
<!-- ... -->
</div>
This can be useful when you want to remove backdrop filters conditionally, such as on hover or at a particular breakpoint.
Applying conditionally
Hover, focus, and other states
Tailwind lets you conditionally apply utility classes in different states using variant modifiers. For example, use hover:backdrop-saturate-150
to only apply the backdrop-saturate-150
utility on hover.
<div class="backdrop-saturate-50 hover:backdrop-saturate-150">
<!-- ... -->
</div>
For a complete list of all available state modifiers, check out the Hover, Focus, & Other States documentation.
Breakpoints and media queries
You can also use variant modifiers to target media queries like responsive breakpoints, dark mode, prefers-reduced-motion, and more. For example, use md:backdrop-saturate-150
to apply the backdrop-saturate-150
utility at only medium screen sizes and above.
<div class="backdrop-saturate-50 md:backdrop-saturate-150">
<!-- ... -->
</div>
To learn more, check out the documentation on Responsive Design, Dark Mode and other media query modifiers.
Using custom values
Customizing your theme
By default, Tailwind includes a handful of general purpose backdrop-saturate
utilities. You can customize these values by editing theme.backdropSaturate
or theme.extend.backdropSaturate
in your tailwind.config.js
file.
tailwind.config.js
module.exports = {
theme: {
extend: {
backdropSaturate: {
25: '.25',
}
}
}
}
Learn more about customizing the default theme in the theme customization documentation.
Arbitrary values
If you need to use a one-off backdrop-saturate
value that doesn’t make sense to include in your theme, use square brackets to generate a property on the fly using any arbitrary value.
<div class="backdrop-saturate-[.25]">
<!-- ... -->
</div>
Learn more about arbitrary value support in the arbitrary values documentation.