Aspect ratio
Source: https://getbootstrap.com/docs/6.0/utilities/aspect-ratio
Make elements maintain specific aspect ratios. Perfect for handling videos, slideshow embeds, and more based on the width of the parent.
Use the ratio utility to manage the aspect ratios of content like <iframe>s, <embed>s, <video>s, and <object>s. These helpers also can be used on any standard HTML child element (e.g., a <div> or <img>). Customize the available aspect ratios with the Sass variable or the utility API.
Pro-Tip! You don’t need frameborder="0" on your <iframe>s as we override that for you in Reboot.
Example
Add your ratio utility to the element you want to modify, like an <iframe>, <video>, or less semantic elements like <div>. Ratio utilities also pair well with any width utilities, as shown below. Customize the available aspect ratios with the Sass variable or the utility API.
<Example code={<iframe class="w-100 ratio-16x9" src="https://www.youtube.com/embed/zpOULjyy-n8?rel=0" title="YouTube video" allowfullscreen></iframe>} />
Swap the .ratio-* class for a different aspect ratio.
<div>Auto</div>
</div> <div class="w-25 ratio-1x1"> <div>1×1</div> </div> <div class="w-50 ratio-4x3"> <div>4×3</div> </div> <div class="w-75 ratio-16x9"> <div>16×9</div> </div> <div class="w-100 ratio-21x9"> <div>21×9</div> </div>`} />
Custom ratios
To set a custom ratio, override --bs-ratio on any .ratio-* element.
<div>2×1</div>
</div>`} />
You can also change the ratio at breakpoints by overriding the same custom property in your own CSS.
.custom-ratio {
--bs-ratio: 4 / 3;
@include media-breakpoint-up(md) {
--bs-ratio: 2 / 1;
}
}
Then apply that class to your markup:
<div class="ratio-auto custom-ratio">
<div>4×3, then 2×1</div>
</div>
CSS
Sass map
Within _config.scss, you can change the aspect ratios you want to use. Here’s our default $aspect-ratios map. Modify the map as you like and recompile your Sass to put them to use.
Sass utilities API
Aspect ratio utilities are declared in our utilities API in scss/_utilities.scss. Learn how to use the utilities API.
