Краткая справка

Класс
Свойства
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 lets you conditionally apply utility classes in different states using variant modifiers. For example, use hover:bg-contain to only apply the bg-contain utility on hover.

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

For a complete list of all available state modifiers, check out the Hover, Focus, & Other States documentation.

Контрольные точки и медиа-запросы

You can also use variant modifiers to target media queries like responsive breakpoints, dark mode, prefers-reduced-motion, and more. For example, use md:bg-contain to apply the bg-contain utility at only medium screen sizes and above.

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

To learn more, check out the documentation on Responsive Design, Dark Mode and other media query modifiers.


Использование пользовательских значений

Настройка вашей темы

По умолчанию Tailwind предоставляет утилиты для размеров фона auto, cover и contain. Вы можете изменить, добавить или удалить их, отредактировав раздел theme.backgroundSize в вашей конфигурации.

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

Дополнительные сведения о настройке темы по умолчанию смотрите в документации настройка темы.

Произвольные значения

If you need to use a one-off background-size value that doesn’t make sense to include in your theme, use square brackets to generate a property on the fly using any arbitrary value.

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

Learn more about arbitrary value support in the arbitrary values documentation.