Ring Color

Usage

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

Changing opacity

You can control the opacity of rings using the ring-opacity-{amount} utilities:

For more information, see the ringOpacity documentation.

Responsive

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

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

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

Customizing

You can customize which ring color utilities are generated by customizing your color palette using the colors key in the theme section of your tailwind.config.js file:

// tailwind.config.js
const colors = require('tailwindcss/colors')

module.exports = {
  theme: {
    colors: {
      gray: colors.blueGray,
      indigo: colors.indigo,
      red: colors.rose,
      yellow: colors.yellow,
    }
  }
}

If you’d like to customize only the ring color utilities without affecting your global color palette, use the ringColor key instead:

// tailwind.config.js
const colors = require('tailwindcss/colors')

module.exports = {
  theme: {
    ringColor: {
      white: colors.white,
      pink: colors.fuchsia,
    }
  }
}

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

Variants

默認情況下, 只有 響應式、深色模式 (如果啟用)、focus-within 和 focus 的 ring color 變化模式 (variants) 會產生。

在 tailwind.config.js 的 variants 區塊中變更 ringColor 屬性來決定有哪些變化模式會生成。

舉個例子來說，這個設定將會生成 響應式 和 hover 的變化模式。

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

Disabling

如果你不打算在專案中使用 ring color 功能，可以在你的設定檔裡的 corePlugins 屬性中將 ringColor 設定為 false 來停用功能：

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