跳到主要内容 跳到文档导航

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

关于

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

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

专家提示!您不需要frameborder="0"在你的元素上 因为我们在Reboot<iframe>中为您覆盖了它。

例子

使用.ratio纵横比类将任何嵌入(例如<iframe>)包裹在父元素中。由于我们的通用选择器.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 纵横比,请在.ratio添加--bs-aspect-ratio: 50%.

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%)
);