跳到主要内容

使用生成的伪元素使元素保持你选择的纵横比。非常适合根据父元素的宽度响应式处理视频或幻灯片嵌入。

关于

使用比例辅助类来管理外部内容(如 <iframe>、<embed>、<video> 和 <object>)的宽高比。这些辅助类也可以用于任何标准的 HTML 子元素(例如,<div> 或 <img>)。样式从父级 .ratio 类直接应用到子元素。

纵横比在 Sass 映射中声明,并通过 CSS 变量包含在每个类中,这也允许自定义纵横比。

专业提示! 你不需要 frameborder="0" 在你的 <iframe>当我们为你覆盖它时 重启.

示例

将任何嵌入内容,例如 <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
  }
}
4乘3,然后2乘1
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%)
);