종횡비

종횡비 (Aspect Ratio)

비디오, 이미지, 지도 등을 삽입할 때 일관된 종횡비(가로세로 비율)를 유지하는 데 사용하는 컴포넌트예요. 콘텐츠의 원래 비율을 덮어써서 원하는 비율로 고정할 수 있어요.

출처: 문서

본문

사용법 (Usage)

ratio prop은 AspectRatio의 자식 콘텐츠 원래 종횡비를 덮어써요. 숫자 값만 허용하며, 문자열은 받지 않아요.

import { AspectRatio } from "@chakra-ui/react"
<AspectRatio ratio={16 / 9}>
  <iframe
    title="naruto"
    src="https://www.youtube.com/embed/QhBnZ6NPOY0"
    allowFullScreen
  />
</AspectRatio>

예제 (Examples)

이미지 (Image)

4 대 3 종횡비를 가진 이미지를 삽입하는 방법이에요.

비디오 (Video)

iframe을 사용해 비디오를 삽입하고, ratio prop으로 비디오의 원래 종횡비를 덮어쓸 수 있어요.

구글 지도 (Google Map)

AspectRatio를 사용해 반응형 구글 지도를 삽입하는 방법이에요.

반응형 (Responsive)

상자에 반응형 종횡비를 적용하는 예시예요.

가이드 (Guide)

종횡비 토큰 (Aspect Ratio Token)

Chakra UI는 square, landscape, portrait, wide, ultrawide, golden을 포함한 미리 정의된 종횡비 토큰도 기본 제공해요. 이 토큰들은 aspectRatio CSS prop에서만 사용할 수 있어요.

:::note

이 토큰들은 AspectRatio가 받는 ratio prop과는 함께 사용할 수 없어요.

:::

<Box aspectRatio="square" />

Props

이 prop들은 AspectRatio 컴포넌트에 전달할 수 있어요.

더 알아보기 (Learn more)