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

Класс
Свойства
aspect-autoaspect-ratio: auto;
aspect-squareaspect-ratio: 1 / 1;
aspect-videoaspect-ratio: 16 / 9;

Основы использования

Установка соотношения сторон

Используйте утилиты aspect-{ratio}, чтобы установить желаемое соотношение сторон элемента.

<iframe class="w-full aspect-video ..." src="https://www.youtube.com/..."></iframe>

Tailwind не включает в себя большой набор значений соотношения сторон по умолчанию, так как проще использовать произвольные значения. См. Раздел произвольные значения для получения дополнительной информации.

Поддержка браузера

Утилиты aspect-{ratio} используют собственное свойство CSS aspect-ratio, которое не поддерживалось в Safari до версии 15. До тех пор, пока не станет популярным Safari 15, плагин Tailwind соотношение сторон является хорошей альтернативой.


Применяя условно

Tailwind позволяет условно применять служебные классы в разных состояниях с помощью модификаторов вариантов. Например, используйте hover:aspect-square, чтобы применять утилиту aspect-square только при hover.

<iframe class="w-full aspect-video hover:aspect-square" src="https://www.youtube.com/..."></iframe>

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

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

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

<iframe class="w-full aspect-video md:aspect-square" src="https://www.youtube.com/..."></iframe>

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


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

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

По умолчанию Tailwind предоставляет минимальный набор aspect-ratio. Вы можете настроить эти значения, отредактировав theme.aspectRatio или theme.extend.aspectRatio в вашем файле tailwind.config.js.

tailwind.config.js
module.exports = {
  theme: {
    extend: {
      aspectRatio: {
        '4/3': '4 / 3',
      },
    }
  }
}

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

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

Если вам нужно использовать одноразовое aspect-ratio value, которое не имеет смысла включать в вашу тему, используйте квадратные скобки, чтобы сгенерировать свойство на лету, используя любое произвольное значение.

<iframe class="w-full aspect-[4/3]" src="https://www.youtube.com/..."></iframe>

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