「及時」模式:全新世代的 Tailwind CSS
Tailwind CSS on GitHub

Ring Opacity

Utilities for setting the opacity of outline rings.

Default class reference

Class
屬性
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

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

tailwind.config.jsvariants 區塊中變更 ringOpacity 屬性來決定有哪些變化模式會生成。

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

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

Disabling

如果你不打算在專案中使用 ring opacity 功能,可以在你的設定檔裡的 corePlugins 屬性中將 ringOpacity 設定為 false 來停用功能:

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