快速参考

属性
bg-autobackground-size: auto;
bg-coverbackground-size: cover;
bg-containbackground-size: contain;

基本用法

自动

使用 bg-auto 以默认大小显示背景图像。

<div class="bg-auto bg-no-repeat bg-center ..." style="background-image: url(...)"></div>

覆盖

使用 bg-cover 将背景图像缩放,直到它填满背景层。

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

包含

使用 bg-contain 将背景图像缩放至外边缘,不会裁剪或拉伸。

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

条件应用

悬停、焦点和其他状态

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

<div class="bg-auto hover:bg-contain">
  <!-- ... -->
</div>

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

断点和媒体查询

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

<div class="bg-auto md:bg-contain">
  <!-- ... -->
</div>

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


使用自定义值

自定义主题

默认情况下,Tailwind 提供了用于autocovercontain背景大小的实用程序。您可以通过编辑配置中的theme.backgroundSize部分来更改、添加或删除这些实用程序。

tailwind.config.js
module.exports = {
  theme: {
    backgroundSize: {
      'auto': 'auto',
      'cover': 'cover',
      'contain': 'contain',
      '50%': '50%',
      '16': '4rem',
    }
  }
}

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

任意值

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

<div class="bg-[length:200px_100px]">
  <!-- ... -->
</div>

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