物件貼合

使用物件貼合工具程式來修改替換元素的內容，例如 <img> 或 <video>，應如何調整大小以符合其容器。

此頁面

運作方式

使用我們的回應式 object-fit 工具程式類別來變更 object-fit 屬性的值。此屬性會以各種方式告知內容填滿父層容器，例如保留長寬比或延伸以佔用盡可能多的空間。

object-fit 的值類別使用 .object-fit-{value} 格式命名。從下列值中選擇

contain
cover
fill
scale（縮小用）
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 值都有回應式變化，使用格式 .object-fit-{breakpoint}-{value}，其中中斷點縮寫如下：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="...">

影片

.object-fit-{value} 和回應式 .object-fit-{breakpoint}-{value} 工具程式也適用於 <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 工具程式 API

物件調整工具程式在 scss/_utilities.scss 中的工具程式 API 中宣告。了解如何使用工具程式 API。

scss/_utilities.scss

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