106k
New

Aspect Ratio

Displays content within a desired ratio.

Photo
import Image from "next/image"
import { AspectRatio } from "@/components/ui/aspect-ratio"

Installation

pnpm dlx shadcn@latest add aspect-ratio

Usage

import { AspectRatio } from "@/components/ui/aspect-ratio"
<AspectRatio ratio={16 / 9}>
  <Image src="..." alt="Image" className="rounded-md object-cover" />
</AspectRatio>

Examples

Square

A square aspect ratio component using the ratio={1 / 1} prop. This is useful for displaying images in a square format.

Photo
import Image from "next/image"
import { AspectRatio } from "@/components/ui/aspect-ratio"

Portrait

A portrait aspect ratio component using the ratio={9 / 16} prop. This is useful for displaying images in a portrait format.

Photo
import Image from "next/image"
import { AspectRatio } from "@/components/ui/aspect-ratio"

RTL

To enable RTL support in shadcn/ui, see the RTL configuration guide.

Photo
منظر طبيعي جميل
"use client"

import * as React from "react"

API Reference

AspectRatio

The AspectRatio component displays content within a desired ratio.

PropTypeDefaultRequired
rationumber-Yes
classNamestring-No

For more information, see the Base UI documentation.