Añadido en v5.3 Ver en GitHub

Object fit

Usa las utilidades object fit para modificar cómo el contenido de un elemento reemplazado, como un <img> o <video>, debe redimensionarse para ajustarse a su contenedor.

On this page

Cómo funciona

Cambia el valor de la propiedad object-fit con nuestras clases de utilidad responsive object-fit. Esta propiedad indica al contenido que rellene el contenedor padre de diversas maneras, como preservando la relación de aspecto o estirándose para ocupar tanto espacio como sea posible.

Las clases para el valor de object-fit se nombran usando el formato .object-fit-{value}. Elige entre los siguientes valores:

contain
cover
fill
scale (para scale-down)
none

Ejemplos

Añade la clase object-fit-{value} al elemento reemplazado:

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="...">

Responsive

También existen variaciones responsive para cada valor de object-fit usando el formato .object-fit-{breakpoint}-{value}, para las siguientes abreviaturas de breakpoints: sm, md, lg, xl, y xxl. Las clases se pueden combinar para diversos efectos según lo necesites.

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

Las utilidades .object-fit-{value} y responsive .object-fit-{breakpoint}-{value} también funcionan en elementos <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

API de utilidades de Sass

Las utilidades object fit están declaradas en nuestra API de utilidades en scss/_utilities.scss. Aprende a usar la API de utilidades.

scss/_utilities.scss

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