CKTIS / CSS
object-position – posicionar o conteúdo de uma imagem
A propriedade object-position alinha o conteúdo de um elemento substituído, como img, dentro da respetiva caixa de conteúdo. Ao recortar, permite escolher a zona visível sem deslocar o próprio elemento no esquema da página.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
object-position: <position>;
/* Examples */
object-position: center;
object-position: 25% 75%;
object-position: right 10px bottom 20px;object-position posiciona o conteúdo de um elemento substituído, como img, dentro da respetiva caixa de conteúdo. O valor inicial é 50% 50%; a propriedade é herdada. object-fit determina o tamanho do conteúdo, enquanto object-position determina o seu alinhamento — não a posição do elemento no esquema da página.
O tipo <position> aceita left, right, top, bottom, center, comprimentos e percentagens. Num par de valores numéricos, o primeiro controla o eixo horizontal e o segundo o vertical. Um único left significa left center. A forma right 10px bottom 20px especifica afastamentos em relação às extremidades indicadas.
Uma percentagem alinha um ponto do conteúdo com o ponto correspondente da caixa: 100% 50% alinha as extremidades direitas e os centros verticais. Em cada eixo, o afastamento a partir do início é (tamanho da caixa - tamanho do objeto) × percentagem. Ao recortar, a diferença pode ser negativa. Se os tamanhos forem iguais, alterar a percentagem nesse eixo não produz deslocamento.
O conteúdo fora da caixa é recortado; as zonas não cobertas mostram o fundo do elemento. No exemplo, cover mantém as proporções da imagem, e right center deixa visível a metade azul. Esta propriedade não substitui background-position, que posiciona imagens de fundo.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>object-position</title>
<style>
img {
display: block;
width: 120px;
height: 120px;
object-fit: cover;
object-position: right center;
}
</style>
<img alt="Blue square" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='240' height='120' viewBox='0 0 240 120'%3E%3Cpath fill='red' d='M0 0h120v120H0z'/%3E%3Cpath fill='blue' d='M120 0h120v120H120z'/%3E%3C/svg%3E">Resultado
A 120 × 120 CSS-pixel blue square; the red half is clipped.
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.