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

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

关于

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

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

专业提示!你不需要在 <iframe> 上使用 frameborder="0",因为我们在 重启 中为你覆盖了它。

示例

将任何嵌入(如 <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 的纵横比,请在 .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,然后是 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%)
);