Display

Aspect Ratio

Server Component

Constrain content to a fixed width-to-height ratio.

Import

tsx

import { AspectRatio } from "@cronus-ui/ui";

bash

npx cronus-ui add aspect-ratio

Examples

Default

Constrains its content to a fixed width-to-height `ratio` (defaults to 16 / 9). The wrapper fills the available width; stretch the child to fill it.

16 / 9

tsx

<AspectRatio ratio={16 / 9} className="overflow-hidden rounded-xl border border-border">
  <img
    src="/og.png"
    alt="Cover"
    className="h-full w-full object-cover"
  />
</AspectRatio>

Square

Pass `ratio={1}` for a 1:1 box — handy for avatars, thumbnails and tiles.

1 / 1

tsx

<AspectRatio ratio={1} className="overflow-hidden rounded-xl border border-border">
  <img src="/thumb.png" alt="Thumbnail" className="h-full w-full object-cover" />
</AspectRatio>

.cronus

The same component declared in Cronus. Emitted at build time from the audit fixtures — the kernel renders it as HTML with no React.

PortedParity: MatchGeometry 1/1Pixel diff 0 pxLogic 1/1Parity scoreboard

default.cronus

app "audit-fixtures" {
  port 5176
}

style {
  preset aurora
  theme dark
}

component AspectRatioDefault layout:inline style:aspect-ratio {
  label "Framed"
}

page "/audit/aspect-ratio/default" type:custom {
  use AspectRatioDefault
}

API Reference

Generated from the component's exported types.

AspectRatioProps

Extends HTMLAttributes<HTMLDivElement>

Prop	Type	Default	Description
`ratio`	`number`	`16 / 9`	The desired width-to-height ratio, expressed as a number (e.g. `16 / 9`, `1`, `4 / 3`). Defaults to `16 / 9`.
`className`	`string`	—	Additional class names merged onto the root.
`children`	`ReactNode`	—	Contents of the component.
`id`	`string`	—	DOM id of the root element.