1. 边框
  2. 轮廓偏移

Quick reference

属性
outline-offset-0outline-offset: 0px;
outline-offset-1outline-offset: 1px;
outline-offset-2outline-offset: 2px;
outline-offset-4outline-offset: 4px;
outline-offset-8outline-offset: 8px;

基本用法

¥Basic usage

设置轮廓偏移

¥Setting the outline offset

使用 outline-* 工具更改元素轮廓的偏移量。

¥Use the outline-* utilities to change the offset of an element’s outline.

outline-offset-0

outline-offset-2

outline-offset-4

<button class="outline outline-offset-0 ...">Button A</button>
<button class="outline outline-offset-2 ...">Button B</button>
<button class="outline outline-offset-4 ...">Button C</button>

有条件地应用

悬停、聚焦和其他状态

Tailwind 允许你使用变体修饰符在不同状态下有条件地应用工具类。例如,使用hover:outline-offset-2 仅在 hover 时应用 outline-offset-2 工具。

<button class="outline hover:outline-offset-2">
  <!-- ... -->
</button>

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

断点和媒体查询

你还可以使用变体修饰符来定位媒体查询,例如响应式断点、暗黑模式、首选减少运动等。例如,使用 md:outline-offset-2 仅在中等屏幕尺寸及以上时应用 outline-offset-2 工具。

<button class="outline md:outline-offset-2">
  <!-- ... -->
</button>

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


使用自定义值

¥Using custom values

自定义主题

¥Customizing your theme

你可以通过编辑 tailwind.config.js 文件中的 theme.outlineOffsettheme.extend.outlineOffset 来自定义 outline-offset-* 工具。

¥You can customize the outline-offset-* utilities by editing theme.outlineOffset or theme.extend.outlineOffset in your tailwind.config.js file.

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      outlineOffset: {
        3: '3px',
      }
    }
  }
}

主题定制 文档中了解有关自定义默认主题的更多信息。

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

任意值

¥Arbitrary values

如果你需要使用一次性的 outline-offset 值,而该值没有必要包含在你的主题中,请使用方括号动态生成属性,使用任意值。

<button class="outline-offset-[3px]">
  <!-- ... -->
</button>

任意值 文档中了解有关任意值支持的更多信息。