Skip to content

Ring Offset Width 环偏宽度

模拟添加轮廓环时的偏移的实用工具。

ClassProperties

基本用法

设置环偏移宽度

使用 ring-offset-{width} 实用程序来模拟偏移,通过添加实心白色阴影和增加相应轮廓环的厚度来适应偏移。

ring-offset-0

ring-offset-2

ring-offset-4

html
<button class="... ring ring-pink-500 ring-offset-0">Button A</button>
<button class="... ring ring-pink-500 ring-offset-2">Button B</button>
<button class="... ring ring-pink-500 ring-offset-4">Button C</button>

改变偏移颜色

您实际上无法在 CSS 中偏移阴影,因此我们必须使用与父元素背景颜色相匹配的纯色阴影来模拟它。我们默认使用白色,但如果您要在不同的背景颜色上添加环形偏移,则应使用 ring-offset-{color} 实用工具来匹配父元素的背景颜色:

ring-offset-slate-50

html
<button class="ring ring-pink-500 ring-offset-2 ring-offset-slate-50 dark:ring-offset-slate-900 ...">
  Save Changes
</button>

有关更多信息,请参阅环偏色文档。

有条件地应用

悬停、焦点和其他状态

Tailwind 允许您使用变体修饰符在不同状态下有条件地应用实用程序类。例如,使用 hover:ring-offset-4 只在悬停时应用 ring-offset-4 实用程序。

html
<div class="ring-2 ring-offset-2 hover:ring-offset-4">
	<!-- ... -->
</div>

有关所有可用状态修饰符的完整列表,请查看悬停、焦点和其他状态文档。

断点和媒体查询

您还可以使用变体修饰符来针对响应式断点、深色模式、偏好减少动作等媒体查询进行定位。例如,使用 md:ring-offset-4 仅在中等屏幕尺寸及以上应用 ring-offset-4 实用程序。

html
<div class="ring-2 ring-offset-2 md:ring-offset-4">
	<!-- ... -->
</div>

要了解更多信息,请查看有关响应式设计深色模式其他媒体查询修饰符的文档。

使用自定义值

定制您的主题

要定制生成哪些环偏移宽度实用程序,请在 tailwind.config.js 文件的 theme 部分的 ringOffsetWidth 键下添加您的自定义值。

js
/** @type {import('tailwindcss').Config} */
module.exports = {
  theme: {
    extend: {
      ringOffsetWidth: {
        '3': '3px',
        '6': '6px',
        '10': '10px',
      }
    }
  }
}

或者,您可以通过编辑 tailwind.config.js 文件中的 theme.ringColortheme.extend.ringColor 来自定义您的铃声颜色。

有关自定义默认主题的更多信息,请参阅主题自定义文档。

任意值

如果您需要使用一个与主题无关的 ring-offset 值,可以使用方括号来根据任意值动态生成属性。

html
<p class="ring-offset-[3px]">
	<!-- ... -->
</p>

有关任意值支持的更多信息,请参阅任意值文档。

Released under the MIT License.