Aspect Ratio
A box that keeps a fixed width-to-height ratio for the media or content placed inside it.
On this page
Tag <sb-aspect-ratio> · status stable · version 0.1.0
Example
<div style="width:20rem">
<sb-aspect-ratio ratio="1.7778">
<img alt="Striped placeholder" style="object-fit:cover;border-radius:var(--sb-radius-surface)" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='160' height='90' viewBox='0 0 160 90'%3E%3Crect width='160' height='90' fill='%23888'/%3E%3Cpath d='M0 90 60 30l30 30 20-20 50 50z' fill='%23bbb'/%3E%3C/svg%3E" />
</sb-aspect-ratio>
</div>
Properties
| Name | Type | Default | Notes |
|---|---|---|---|
ratio |
number | 1 |
Width divided by height. Accepts a number (1.7778) or a fraction written as 16/9. Invalid or non-positive values fall back to 1. |
Accessibility
- Role:
none: the box adds no semantics - Accessible name: None. The slotted content is named as usual (alt text on an img, title on an iframe).