File: aspect-ratio.md | Updated: 11/15/2025
ThemesThemes PrimitivesPrimitives IconsIcons ColorsColors
Documentation Case studies Blog
Search
/
Introduction Getting started Accessibility Releases
Styling Animation Composition Server-side rendering
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
Accessible Icon Direction Provider Portal Slot Visually Hidden
Components
Displays content within a desired ratio.
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;
Accepts any custom ratio.
Install the component from your command line.
npm install @radix-ui/react-aspect-ratio
Import the component.
import { AspectRatio } from "radix-ui";
export default () => <AspectRatio.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