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

比率(Ratios)

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

关于

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

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

专业提示!<iframe>中你不需要 frameborder="0",因为我们在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 纵横比,请在 .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%)
);