Tailwind CSS on GitHub

Ring Opacity

Utilities for setting the opacity of outline rings.

Default class reference

Class
Properties
ring-opacity-0--tw-ring-opacity: 0;
ring-opacity-5--tw-ring-opacity: 0.05;
ring-opacity-10--tw-ring-opacity: 0.1;
ring-opacity-20--tw-ring-opacity: 0.2;
ring-opacity-25--tw-ring-opacity: 0.25;
ring-opacity-30--tw-ring-opacity: 0.3;
ring-opacity-40--tw-ring-opacity: 0.4;
ring-opacity-50--tw-ring-opacity: 0.5;
ring-opacity-60--tw-ring-opacity: 0.6;
ring-opacity-70--tw-ring-opacity: 0.7;
ring-opacity-75--tw-ring-opacity: 0.75;
ring-opacity-80--tw-ring-opacity: 0.8;
ring-opacity-90--tw-ring-opacity: 0.9;
ring-opacity-95--tw-ring-opacity: 0.95;
ring-opacity-100--tw-ring-opacity: 1;

Usage

Use the ring-opacity-{amount} utilities to set the opacity of an outline ring.

<button class="... ring-4 ring-red-500 ring-opacity-50">
  Button
</button>

Responsive

To control the ring opacity at a specific breakpoint, add a {screen}: prefix to any existing ring opacity utility. For example, use md:ring-opacity-50 to apply the ring-opacity-50 utility at only medium screen sizes and above.

<button class="ring-2 ring-blue-500 ring-opacity-75 md:ring-opacity-50">
  <!-- ... -->
</button>

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


Customizing

You can customize which ring opacity utilities are generated by customizing your global opacity scale under the opacity key in the theme section of your tailwind.config.js file:

  // tailwind.config.js
  module.exports = {
    theme: {
      extend: {
        opacity: {
+         '15': '0.15',
+         '35': '0.35',
+         '65': '0.65',
        }
      }
    }
  }

If you'd like to customize only the ring opacity utilities without affecting your global opacity scale, use the ringOpacity key instead:

  // tailwind.config.js
  module.exports = {
    theme: {
      extend: {
        ringOpacity: {
+         '15': '0.15',
+         '35': '0.35',
+         '65': '0.65',
        }
      }
    }
  }

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

Variants

By default, only responsive, focus-within and focus variants are generated for ring opacity utilities.

You can control which variants are generated for the ring opacity utilities by modifying the ringOpacity property in the variants section of your tailwind.config.js file.

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

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

Disabling

If you don't plan to use the ring opacity utilities in your project, you can disable them entirely by setting the ringOpacity property to false in the corePlugins section of your config file:

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