Aspect Ratio

The ArcadiaAspectRatio component constrains its content to a given aspect ratio using the CSS aspect-ratio property.

Basic Usage

<ArcadiaAspectRatio Ratio="16/9">
    <img src="/images/hero.jpg" alt="Hero" style="width:100%; height:100%; object-fit:cover;" />
</ArcadiaAspectRatio>

<ArcadiaAspectRatio Ratio="1/1">
    <div style="background:var(--arcadia-primary); width:100%; height:100%;"></div>
</ArcadiaAspectRatio>

Parameters

ParameterTypeDefaultDescription
Ratiostring"16/9"The aspect ratio in slash notation (e.g., "16/9", "4/3", "1/1", "21/9").
ChildContentRenderFragment?nullContent rendered inside the aspect ratio container.
Classstring?nullAdditional CSS class names.
Stylestring?nullInline CSS styles.

Accessibility

  • This is a layout-only component with no specific ARIA attributes.
  • Ensure child content includes appropriate alt text for images or other accessible labels.