aspect-ratio

Utilities for controlling the aspect ratio of an element.

2025-04-16

Written by: tdtc

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

Basic example

Use aspect- utilities like aspect-3/2 to give an element a specific aspect ratio:

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

Using a video aspect ratio

Use the aspect-video utility to give a video element a 16 / 9 aspect ratio:

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

Using a custom value

Use the aspect-[] syntax to set the aspect ratio based on a completely custom value:

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

Ref