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

Класс
Свойства
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 только при hover.

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

Полный список всех доступных модификаторов состояния смотрите в документации Наведение, фокус и другие состояния.

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

Вы также можете использовать модификаторы вариантов для таргетинга на медиа-запросы, такие как реагирующие контрольные точки, темный режим, предпочтения с уменьшенным движением и многое другое. Например, используйте md:bg-contain, чтобы применить утилиту bg-contain только на экранах среднего размера и выше.

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

Чтобы узнать больше, ознакомьтесь с документацией по адаптивному дизайну, темному режиму и другим модификаторам медиазапросов.


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

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

По умолчанию Tailwind предоставляет утилиты для размеров фона auto, cover и contain. Вы можете изменить, добавить или удалить их, отредактировав раздел 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>

Узнайте больше о поддержке произвольных значений в документации по произвольным значениям.