Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes