Перейти к основному контенту Перейти к навигации документации

Используйте генерируемые псевдоэлементы, чтобы элемент поддерживал выбранное вами соотношение сторон. Идеально подходит для отзывчивой обработки встраиваемых видео или слайд-шоу на основе ширины родителя.

О помощнике

Используйте помощник соотношений для управления пропорциями внешнего контента, такого как <iframe>, <embed>, <video> и <object>. Эти помощники также можно использовать с любым стандартным дочерним HTML-элементом (например, <div> или <img>). Стили применяются от родительского класса .ratio непосредственно к дочернему элементу.

Соотношения сторон объявляются в карте Sass и включаются в каждый класс через CSS-переменную, что также позволяет использовать пользовательские соотношения сторон.

Профессиональный совет! Вам не нужен frameborder="0" для ваших <iframe>, так как мы переопределяем это для вас в Reboot.

Пример

Оберните любую вставку, например <iframe>, в родительский элемент с классом .ratio и классом соотношения сторон. Непосредственный дочерний элемент автоматически изменяется в размере благодаря нашему универсальному селектору .ratio > *.

html
<div class="ratio ratio-16x9">
  <iframe src="https://www.youtube.com/embed/zpOULjyy-n8?rel=0" title="YouTube video" allowfullscreen></iframe>
</div>

Соотношения сторон

Соотношения сторон можно настраивать с помощью классов-модификаторов. По умолчанию предоставляются следующие классы соотношений:

1x1
4x3
16x9
21x9
html
<div class="ratio ratio-1x1">
  <div>1x1</div>
</div>
<div class="ratio ratio-4x3">
  <div>4x3</div>
</div>
<div class="ratio ratio-16x9">
  <div>16x9</div>
</div>
<div class="ratio ratio-21x9">
  <div>21x9</div>
</div>

Пользовательские соотношения

Каждый класс .ratio-* включает пользовательское CSS-свойство (или CSS-переменную) в селекторе. Вы можете переопределить эту CSS-переменную, чтобы создавать пользовательские соотношения сторон на лету с помощью простых вычислений с вашей стороны.

Например, чтобы создать соотношение сторон 2x1, установите --bs-aspect-ratio: 50% для .ratio.

2x1
html
<div class="ratio" style="--bs-aspect-ratio: 50%;">
  <div>2x1</div>
</div>

Эта CSS-переменная упрощает изменение соотношения сторон в различных контрольных точках. Следующий пример начинается с 4x3, но изменяется на пользовательское 2x1 в средней контрольной точке.

.ratio-4x3 {
  @include media-breakpoint-up(md) {
    --bs-aspect-ratio: 50%; // 2x1
  }
}
4x3, then 2x1
html
<div class="ratio ratio-4x3">
  <div>4x3, then 2x1</div>
</div>

Карты Sass

В _variables.scss вы можете изменить соотношения сторон, которые хотите использовать. Вот наша карта $ratio-aspect-ratios по умолчанию. Измените карту по своему усмотрению и перекомпилируйте Sass, чтобы использовать их.

$aspect-ratios: (
  "1x1": 100%,
  "4x3": calc(3 / 4 * 100%),
  "16x9": calc(9 / 16 * 100%),
  "21x9": calc(9 / 21 * 100%)
);