View on GitHub

Object fit

使用 object fit utilities 修改替换的元素的内容的方式，如<img>或<video>，应调整大小以适应其容器。

On this page

工作原理

更改object-fit属性的值使用我们的响应 object-fit utility 类。此属性告诉内容以多种方式填充父容器，例如保留纵横比或拉伸以占用尽可能多的空间。

值为object-fit的类使用格式.object-fit-{value｝命名。从以下值中进行选择：

contain
cover
fill
scale (for scale-down)
none

示例

将 object-fit-{value} 类添加到替换的元素：

html

<img src="..." class="object-fit-contain border rounded" alt="...">
<img src="..." class="object-fit-cover border rounded" alt="...">
<img src="..." class="object-fit-fill border rounded" alt="...">
<img src="..." class="object-fit-scale border rounded" alt="...">
<img src="..." class="object-fit-none border rounded" alt="...">

响应式

使用.object-fit-{breakpoint}-{value} 格式的每个object-fit 也存在响应式变化，表示以下断点缩写：sm、md、lg、xl和xxl。可以根据需要组合类以获得各种效果。

html

<img src="..." class="object-fit-sm-contain border rounded" alt="...">
<img src="..." class="object-fit-md-contain border rounded" alt="...">
<img src="..." class="object-fit-lg-contain border rounded" alt="...">
<img src="..." class="object-fit-xl-contain border rounded" alt="...">
<img src="..." class="object-fit-xxl-contain border rounded" alt="...">

Video

.object-fit-{value}和响应式 .object-fit-{breakpoint}-{value} utilities 也适用于<video> 元素。

<video src="..." class="object-fit-contain" autoplay></video>
<video src="..." class="object-fit-cover" autoplay></video>
<video src="..." class="object-fit-fill" autoplay></video>
<video src="..." class="object-fit-scale" autoplay></video>
<video src="..." class="object-fit-none" autoplay></video>

CSS

Sass utilities API

Object fit utilities 在我们的utilities API 中声明为scss/_utilities.scss。了解如何使用实用程序API。

scss/_utilities.scss

"object-fit": (
  responsive: true,
  property: object-fit,
  values: (
    contain: contain,
    cover: cover,
    fill: fill,
    scale: scale-down,
    none: none,
  )
),