CKTIS / CSS
object-fit — ajustar o conteúdo à caixa de um elemento
object-fit determina como o conteúdo de um elemento substituído se ajusta à sua caixa de conteúdo. Permite manter as proporções, recortar uma imagem ou esticá-la sem alterar as dimensões da caixa do elemento.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
object-fit: fill | none | [contain | cover] || scale-down;object-fit controla a forma como o conteúdo de um elemento substituído, como uma imagem img, se ajusta à sua caixa de conteúdo. A propriedade não define as dimensões dessa caixa: no exemplo, são width e height que o fazem. O valor inicial é fill; não é herdada e a sua animação é discreta.
fill preenche a caixa e pode distorcer as proporções. contain mantém as proporções e faz caber todo o conteúdo, podendo deixar faixas vazias. cover mantém as proporções e cobre toda a caixa, recortando o conteúdo quando necessário. none não redimensiona o conteúdo para o ajustar: usa o algoritmo de dimensionamento predefinido, que normalmente resulta nas dimensões naturais. scale-down escolhe o menor resultado entre none e contain.
As áreas vazias mostram o fundo do elemento e o conteúdo que ultrapassa a caixa é recortado. object-position controla o posicionamento. Esta propriedade ajusta o conteúdo do elemento, não uma imagem de fundo controlada por background-size.
A gramática de nível 4 também permite combinar scale-down com contain ou cover; scale-down isolado significa contain scale-down. A variante cover scale-down escolhe o menor resultado entre none e cover, pelo que pode deixar espaço vazio. A inclusão de uma combinação na especificação não confirma o seu suporte nos browsers; estas combinações têm de ser verificadas separadamente.
Exemplos
<!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.
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.