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

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

Обзор

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

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

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

Пример

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

<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
<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
<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, затем 2x1
<div class="ratio ratio-4x3">
  <div>4x3, затем 2x1</div>
</div>

Карта Sass

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

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