<iframe src="https://www.googletagmanager.com/ns.html?id=GTM-5HGSQD2L" height="0" width="0" style="display:none;visibility:hidden" title="GTM"></iframe>

Aspect Ratio

A container with a consistent width-to-height ratio.

In React, AspectRatio is a container that will always maintain the same width-to-height ratio. It will expand to fill as much width as possible.

Usage

AspectRatio exposes a single prop called ratio.

ratio can be calculated by dividing the content's height by its width.

e.g. 1) If your content is 16px wide and 9px tall, your ratio is 9 / 16 = 0.5625

e.g. 2) If your content is a square, your ratio is 1

Try tweaking the ratio prop and resizing the playground. Notice that the box always retains the same aspect ratio as the container changes size!

The preview has been updated.

Props

AspectRatio
This component is implemented using the <span /> as the root element. You can utilize the native attributes supported by <span /> tag. The ref is directly assigned to the root element, allowing you to access and manipulate it as needed.
See core props for additional props that can be applied to this component.
proptyperequireddefault
ratio
The height / width ratio expressed as the result of dividing the content's height by its width. e.g. 1) If your content is 16px wide and 9px tall, your ratio is 9 / 16 = 0.5625. e.g. 2) If your content is a square, your ratio is 1.
numbertrue
null
AspectRatioContainer
This component is implemented using the <span /> as the root element. You can utilize the native attributes supported by <span /> tag. The ref is directly assigned to the root element, allowing you to access and manipulate it as needed.
See core props for additional props that can be applied to this component.
proptyperequireddefault
ratio
The height / width ratio expressed as the result of dividing the content's height by its width. e.g. 1) If your content is 16px wide and 9px tall, your ratio is 9 / 16 = 0.5625. e.g. 2) If your content is a square, your ratio is 1.
numbertrue
null
AspectRatioContent
This component is implemented using the <span /> as the root element. You can utilize the native attributes supported by <span /> tag. The ref is directly assigned to the root element, allowing you to access and manipulate it as needed.
See core props for additional props that can be applied to this component.