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

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

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

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:aspect-square to apply the aspect-square utility at only medium screen sizes and above.

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

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


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

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

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

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

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

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

If you need to use a one-off aspect-ratio 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.

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

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