Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

object-fit — ajustar el contenido al cuadro de un elemento

object-fit determina cómo se ajusta el contenido de un elemento reemplazado a su cuadro de contenido. Permite conservar las proporciones, recortar una imagen o estirarla sin cambiar las dimensiones del cuadro del elemento.

Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxis

object-fit: fill | none | [contain | cover] || scale-down;

object-fit controla cómo se ajusta el contenido de un elemento reemplazado, como una imagen img, a su cuadro de contenido. No establece las dimensiones de ese cuadro: en el ejemplo, lo hacen width y height. Su valor inicial es fill; no se hereda y su animación es discreta.

fill llena el cuadro y puede distorsionar las proporciones. contain conserva las proporciones y hace que quepa todo el contenido, aunque pueden quedar bandas vacías. cover conserva las proporciones y cubre todo el cuadro, recortando el contenido cuando es necesario. none no cambia el tamaño del contenido para ajustarlo: usa el algoritmo de dimensionamiento predeterminado, que normalmente da como resultado las dimensiones naturales. scale-down elige el menor resultado entre none y contain.

Las zonas vacías muestran el fondo del elemento, y el contenido que sobresale del cuadro se recorta. object-position controla la posición. Esta propiedad ajusta el contenido del elemento, no una imagen de fondo controlada por background-size.

La gramática de nivel 4 también permite combinar scale-down con contain o cover; scale-down por sí solo significa contain scale-down. La variante cover scale-down elige el menor resultado entre none y cover, por lo que puede dejar espacio vacío. Que una combinación aparezca en la especificación no confirma que los navegadores la admitan; estas combinaciones deben verificarse por separado.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>object-fit: contain</title>
<style>
  img {
    display: block;
    width: 120px;
    height: 120px;
    object-fit: contain;
    object-position: center;
    background: #ddd;
  }
</style>
<img alt="Red rectangle" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='200' height='100' viewBox='0 0 200 100'%3E%3Cpath fill='red' d='M0 0H200V100H0Z'/%3E%3C/svg%3E">

Resultado

A 120 × 120 CSS-pixel image box containing a centered 120 × 60 red rectangle, with 30 CSS-pixel gray bands above and below.

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes