快速参考

属性
bg-bottombackground-position: bottom;
bg-centerbackground-position: center;
bg-leftbackground-position: left;
bg-left-bottombackground-position: left bottom;
bg-left-topbackground-position: left top;
bg-rightbackground-position: right;
bg-right-bottombackground-position: right bottom;
bg-right-topbackground-position: right top;
bg-topbackground-position: top;

基本用法

设置背景位置

使用 bg-{side} 实用程序来控制元素背景图像的位置。

bg-left-top

bg-top

bg-right-top

bg-left

bg-center

bg-right

bg-left-bottom

bg-bottom

bg-right-bottom

<div class="bg-no-repeat bg-left-top ..." style="background-image: url(...);"></div>
<div class="bg-no-repeat bg-top ..." style="background-image: url(...);"></div>
<div class="bg-no-repeat bg-right-top ..." style="background-image: url(...);"></div>
<div class="bg-no-repeat bg-left ..." style="background-image: url(...);"></div>
<div class="bg-no-repeat bg-center ..." style="background-image: url(...);"></div>
<div class="bg-no-repeat bg-right ..." style="background-image: url(...);"></div>
<div class="bg-no-repeat bg-left-bottom ..." style="background-image: url(...);"></div>
<div class="bg-no-repeat bg-bottom ..." style="background-image: url(...);"></div>
<div class="bg-no-repeat bg-right-bottom ..." style="background-image: url(...);"></div>

有条件地应用

悬停、焦点和其他状态

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

<div class="bg-center hover:bg-top ..." style="background-image: url(...)"></div>

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

断点和媒体查询

您还可以使用变体修饰符来针对媒体查询,例如响应式断点、暗模式、 prefers-reduced-motion 等等。例如,使用 md:bg-top 仅在中等屏幕尺寸及以上应用 bg-top 实用程序。

<div class="bg-center md:bg-top ..." style="background-image: url(...)"></div>

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


使用自定义值

自定义主题

默认情况下,Tailwind 提供九个 background-position 实用程序。您可以通过编辑 Tailwind 配置的 theme.backgroundPosition 部分来更改、添加或删除这些实用程序。

tailwind.config.js
module.exports = {
  theme: {
    backgroundPosition: {
      bottom: 'bottom',
      'bottom-4': 'center bottom 1rem',
      center: 'center',
      left: 'left',
      'left-bottom': 'left bottom',
      'left-top': 'left top',
      right: 'right',
      'right-bottom': 'right bottom',
      'right-top': 'right top',
      top: 'top',
      'top-4': 'center top 1rem',
    }
  }
}

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

任意值

如果您需要使用一次性的 `background-position` 值,而该值不适合包含在您的主题中,请使用方括号使用任意值动态生成属性。

<div class="bg-[center_top_1rem]">
  <!-- ... -->
</div>

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