📄 radixui/primitives/docs/components/aspect-ratio

File: aspect-ratio.md | Updated: 11/15/2025

Source: https://www.radix-ui.com/primitives/docs/components/aspect-ratio

Radix Homepage

Made by WorkOS

Radix Homepage

Made by WorkOS

ThemesThemes PrimitivesPrimitives IconsIcons ColorsColors

Documentation Case studies Blog

Search

/

Overview

Introduction Getting started Accessibility Releases

Guides

Styling Animation Composition Server-side rendering

Components

Accordion Alert Dialog Aspect Ratio Avatar Checkbox Collapsible Context Menu Dialog Dropdown Menu Form

Preview
Hover Card Label Menubar Navigation Menu One-Time Password Field

Preview
Password Toggle Field

Preview
Popover Progress Radio Group Scroll Area Select Separator Slider Switch Tabs Toast Toggle Toggle Group Toolbar Tooltip

Utilities

Accessible Icon Direction Provider Portal Slot Visually Hidden

Components

Aspect Ratio

Displays content within a desired ratio.

Landscape photograph by Tobias Tullius

index.jsxindex.jsxstyles.cssstyles.css

CSS

import * as React from "react";
import { AspectRatio } from "radix-ui";
import "./styles.css";

const AspectRatioDemo = () => (
	<div className="Container">
		<AspectRatio.Root ratio={16 / 9}>
			<img
				className="Image"
				src="https://images.unsplash.com/photo-1535025183041-0991a977e25b?w=300&dpr=2&q=80"
				alt="Landscape photograph by Tobias Tullius"
			/>
		</AspectRatio.Root>
	</div>
);

export default AspectRatioDemo;

Features

Accepts any custom ratio.

Installation


Install the component from your command line.

npm install @radix-ui/react-aspect-ratio

Anatomy


Import the component.

import { AspectRatio } from "radix-ui";

export default () => <AspectRatio.Root />;

API Reference


Root

Contains the content you want to constrain to a given ratio.

| Prop | Type | Default | | --- | --- | --- | | asChild<br><br>Prop description | boolean | false | | ratio<br><br>Prop description | number | 1 |

PreviousAlert Dialog

NextAvatar

Edit this page on GitHub.