Quick reference

Class
Properties
aspect-autoaspect-ratio: auto;
aspect-squareaspect-ratio: 1 / 1;
aspect-videoaspect-ratio: 16 / 9;

Basic usage

요소의 종횡비 설정하기

요소의 원하는 종횡비를 설정하려면 aspect-* 유틸리티를 사용하세요.

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

Tailwind는 기본적으로 다양한 종횡비 값을 포함하지 않습니다. 임의의 값을 사용하는 것이 더 쉽기 때문입니다. 자세한 내용은 임의 값 섹션을 참고하세요.

브라우저 지원

aspect-* 유틸리티는 기본 CSS 속성인 aspect-ratio를 사용합니다. 이 속성은 Safari 15 버전까지 지원되지 않았습니다. Safari 15가 널리 보급되기 전까지는 Tailwind의 aspect-ratio 플러그인을 대안으로 사용할 수 있습니다.


Applying conditionally

호버, 포커스 및 기타 상태

Tailwind는 상태에 따라 유틸리티 클래스를 조건부로 적용할 수 있게 해줍니다. 예를 들어, hover:aspect-square 를 사용하면 aspect-square 유틸리티를 hover 상태에서만 적용할 수 있습니다.

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

사용 가능한 모든 상태 수정자 목록은 호버, 포커스, & 기타 상태 문서를 참고하세요.

브레이크포인트와 미디어 쿼리

여러분은 반응형 브레이크포인트, 다크 모드, prefers-reduced-motion 등과 같은 미디어 쿼리를 타겟팅하기 위해 변형 수식어를 사용할 수 있습니다. 예를 들어, md:aspect-square를 사용하면 중간 화면 크기 이상에서만 aspect-square 유틸리티를 적용할 수 있습니다.

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

더 자세히 알아보려면 반응형 디자인, 다크 모드, 그리고 다른 미디어 쿼리 수식어에 대한 문서를 확인하세요.


Using custom values

테마 커스터마이징

기본적으로 Tailwind는 최소한의 aspect-ratio 유틸리티를 제공합니다. tailwind.config.js 파일에서 theme.aspectRatio 또는 theme.extend.aspectRatio를 수정하여 이 값을 커스터마이징할 수 있습니다.

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

기본 테마 커스터마이징에 대해 더 알아보려면 테마 커스터마이징 문서를 참고하세요.

임의 값

테마에 포함시키기 어려운 aspect-ratio 값을 일회성으로 사용해야 한다면, 대괄호를 사용해 임의의 값으로 속성을 즉석에서 생성할 수 있습니다.

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

임의 값 지원에 대해 더 알아보려면 임의 값 문서를 참고하세요.