Contrast
Tailwind CSS version
v2.1+
Utilities for applying contrast filters to an element.
Default class reference
Class | Properties |
---|---|
contrast-0 | —tw-contrast: contrast(0); |
contrast-50 | —tw-contrast: contrast(.5); |
contrast-75 | —tw-contrast: contrast(.75); |
contrast-100 | —tw-contrast: contrast(1); |
contrast-125 | —tw-contrast: contrast(1.25); |
contrast-150 | —tw-contrast: contrast(1.5); |
contrast-200 | —tw-contrast: contrast(2); |
Usage
Use the contrast-{amount?}
utilities alongside the filter
utility to control an element’s contrast.
<div class="filter contrast-125 ...">
<!-- ... -->
</div>
Responsive
To control an element’s contrast at a specific breakpoint, add a {screen}:
prefix to any existing contrast utility. For example, use md:contrast-150
to apply the contrast-150
utility at only medium screen sizes and above.
<div class="filter contrast-110 md:contrast-150 ...">
<!-- ... -->
</div>
For more information about Tailwind’s responsive design features, check out the Responsive Design documentation.
Customizing
You can customize which contrast
utilities are generated using the contrast
key in the theme
section of your tailwind.config.js
file.
// tailwind.config.js
module.exports = {
theme: {
+ extend: {
+ contrast: {
+ 25: '.25',
+ }
+ }
}
}
Learn more about customizing the default theme in the theme customization documentation.
Variants
By default, only responsive variants are generated for contrast utilities.
You can control which variants are generated for the contrast utilities by modifying the contrast
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: {
// ...
+ contrast: ['hover', 'focus'],
}
}
}
Disabling
If you don’t plan to use the contrast utilities in your project, you can disable them entirely by setting the contrast
property to false
in the corePlugins
section of your config file:
// tailwind.config.js
module.exports = {
corePlugins: {
// ...
+ contrast: false,
}
}