Aspect Ratio

Utility classes to constrain elements to common aspect ratios. Content scales to fill while maintaining proportion.

Video (16:9)

Add sui-aspect sui-aspect-video for widescreen 16:9 ratio.

16 : 9
<div class="sui-aspect sui-aspect-video" style="max-width:400px;">
  <img src="..." alt="..." />
</div>

Square (1:1)

Add sui-aspect-square for a 1:1 ratio, for avatars and thumbnails.

1 : 1
<div class="sui-aspect sui-aspect-square" style="max-width:200px;">
  <img src="..." alt="..." />
</div>

Portrait (9:16)

Add sui-aspect-portrait for a 9:16 ratio, for phone mockups and stories.

9 : 16
<div class="sui-aspect sui-aspect-portrait" style="max-width:160px;">
  <img src="..." alt="..." />
</div>

4:3

Add sui-aspect-4-3 for the classic 4:3 ratio.

4 : 3
<div class="sui-aspect sui-aspect-4-3" style="max-width:320px;">
  <img src="..." alt="..." />
</div>

3:2

Add sui-aspect-3-2 for a photo-friendly 3:2 ratio.

3 : 2
<div class="sui-aspect sui-aspect-3-2" style="max-width:360px;">
  <img src="..." alt="..." />
</div>

4:5

Add sui-aspect-4-5 for a 4:5 ratio, common for social feed images.

4 : 5
<div class="sui-aspect sui-aspect-4-5" style="max-width:240px;">
  <img src="..." alt="..." />
</div>

Ultrawide (21:9)

Add sui-aspect-21-9 for a cinematic ultrawide ratio.

21 : 9
<div class="sui-aspect sui-aspect-21-9" style="max-width:500px;">
  <img src="..." alt="..." />
</div>

With Content

Direct children fill the box, and images are cropped with object-fit: cover automatically.

Video Player 16:9 container
Avatar
Photo Card 4:3 container
<div class="sui-aspect sui-aspect-video" style="max-width:280px;border-radius:var(--sui-radius-sm);box-shadow:var(--sui-shadow-raised-sm);">
  <div style="display:flex;flex-direction:column;align-items:center;justify-content:center;gap:8px;background:var(--sui-bg);padding:16px;">
    <div style="width:48px;height:48px;border-radius:50%;background:linear-gradient(135deg, #7C5CFC, #5B54E0);"></div>
    <span style="font-size:14px;font-weight:600;color:var(--sui-text);">Video Player</span>
    <span style="font-size:12px;color:var(--sui-text-muted);">16:9 container</span>
  </div>
</div>
<div class="sui-aspect sui-aspect-square" style="max-width:160px;border-radius:var(--sui-radius-sm);box-shadow:var(--sui-shadow-raised-sm);">
  <div style="display:flex;flex-direction:column;align-items:center;justify-content:center;gap:6px;background:var(--sui-bg);padding:16px;">
    <div style="width:40px;height:40px;border-radius:50%;background:linear-gradient(135deg, #2DCE89, #1AAB6B);"></div>
    <span style="font-size:13px;font-weight:600;color:var(--sui-text);">Avatar</span>
  </div>
</div>
<div class="sui-aspect sui-aspect-4-3" style="max-width:220px;border-radius:var(--sui-radius-sm);box-shadow:var(--sui-shadow-raised-sm);">
  <div style="display:flex;flex-direction:column;align-items:center;justify-content:center;gap:8px;background:var(--sui-bg);padding:16px;">
    <div style="width:48px;height:36px;border-radius:6px;background:linear-gradient(135deg, #36D1DC, #5B86E5);"></div>
    <span style="font-size:14px;font-weight:600;color:var(--sui-text);">Photo Card</span>
    <span style="font-size:12px;color:var(--sui-text-muted);">4:3 container</span>
  </div>
</div>

Delete this item?

This action cannot be undone. This will permanently delete the item and remove all associated data.