Skip to main content Skip to docs navigation

比率

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

关于

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

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

专业提示!您的 <iframe> 上不需要 frameborder="0",因为我们会 重置 中设置它。

示例

使用 .ratio 和宽高比类将任何嵌入(如 <iframe>)包装在父元素中。 由于我们的通配符选择器 .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 长宽比,请在 .ratio 上设置 --bs-aspect-ratio: 50%

2x1
<div class="ratio" style="--bs-aspect-ratio: 50%;">
  <div>2x1</div>
</div>

这个 CSS 变量可以很容易地在不同断点处修改长宽比。 以下是开始 4x3,但在 medium 断点处更改为自定义 2x1。

.ratio-4x3 {
  @include media-breakpoint-up(md) {
    --bs-aspect-ratio: 50%; // 2x1
  }
}
4x3, then 2x1
<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%)
);