Ring Width

Utilities for creating outline rings with box-shadows.

Use the utilities to apply solid box-shadow of a specific thickness to an element. Rings are a semi-transparent blue color by default, similar to the default focus ring style in many systems.

Ring utilities compose gracefully with regular shadow-{size} utilities and can be combined on the same element.

You can also control the color, opacity, and offset of rings using the , ringOpacity, and utilities.

Focus rings

The ring width utilities make it easy to use custom focus rings by adding focus: to the beginning of any ring-{width} utility.

Focus this button to see the ring appear

<button class="... focus:ring-2">Save Changes</button>

The focus variant is enabled by default for the , ringOpacity, , and ringOffsetColor utilities as well.

Use the ring-inset utility to force a ring to render on the inside of an element instead of the outside. This can be useful for elements at the edge of the screen where part of the ring wouldn’t be visible.

Hover, focus, and other states

Tailwind lets you conditionally apply utility classes in different states using variant modifiers. For example, use hover:ring-4 to only apply the ring-4 utility on hover.

  <!-- ... -->
</div>

You can also use variant modifiers to target media queries like responsive breakpoints, dark mode, prefers-reduced-motion, and more. For example, use md:ring-4 to apply the ring-4 utility at only medium screen sizes and above.

To learn more, check out the documentation on , Dark Mode and .

Customizing your theme

By default, Tailwind includes a handful of general purpose ring-width utilities. You can customize these values by editing theme.ringWidth or theme.extend.ringWidth in your tailwind.config.js file.

tailwind.config.js

  theme: {
    extend: {
      ringWidth: {
        '10': '10px',
      }
    }
  }

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

If you need to use a one-off 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.