1. 레이아웃
  2. aspect-ratio

레이아웃

aspect-ratio

엘리먼트의 종횡비를 제어하는 유틸리티입니다.

ClassStyles
aspect-<ratio>
aspect-ratio: <ratio>;
aspect-square
aspect-ratio: 1 / 1;
aspect-video
aspect-ratio: var(--aspect-ratio-video); /* 16 / 9 */
aspect-auto
aspect-ratio: auto;
aspect-(<custom-property>)
aspect-ratio: var(<custom-property>);
aspect-[<value>]
aspect-ratio: <value>;

예제

기본 예제

aspect-<ratio> 유틸리티를 사용해 요소에 특정 비율을 지정할 수 있습니다. 예를 들어 aspect-3/2를 사용하면 요소의 가로 세로 비율을 3:2로 설정할 수 있습니다.

예제의 크기를 조절해 예상된 동작을 확인하세요

<img class="aspect-3/2 object-cover ..." src="/img/villas.jpg" />

비디오 화면비 사용하기

aspect-video 유틸리티를 사용하여 비디오 엘리먼트에 16:9 화면비를 적용할 수 있습니다:

예제의 크기를 조절하여 예상된 동작을 확인하세요

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

커스텀 값 사용하기

aspect-[<value>] 구문을 사용하세요 aspect ratio를 완전히 커스텀한 값으로 설정하려면:

<img class="aspect-[calc(4*3+1)/3] ..." src="/img/villas.jpg" />

CSS 변수를 사용하려면 aspect-(<custom-property>) 구문을 사용할 수도 있습니다:

<img class="aspect-(--my-aspect-ratio) ..." src="/img/villas.jpg" />

이는 aspect-[var(<custom-property>)] 의 단축 표현으로, 자동으로 var() 함수를 추가해 줍니다.

반응형 디자인

접두사 an aspect-ratio 유틸리티 md:와 같은 브레이크포인트 변형과 함께 사용하면 medium 화면 크기 이상에서만 유틸리티가 적용됩니다:

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

변형 사용에 대해 더 알아보려면 변형 문서를 참고하세요.

테마 커스터마이징

--aspect-* 테마 변수를 사용해 프로젝트에서 aspect ratio 유틸리티를 커스터마이징할 수 있습니다:

@theme {  --aspect-retro: 4 / 3; }

이제 aspect-retro 유틸리티를 마크업에서 사용할 수 있습니다:

<iframe class="aspect-retro" src="https://www.youtube.com/embed/dQw4w9WgXcQ"></iframe>

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

Copyright © 2025 Tailwind Labs Inc.·Trademark Policy