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

CKTIS / CSS

object-view-box — a região de referência do conteúdo

object-view-box seleciona uma região retangular do conteúdo de um elemento substituído, permitindo ampliar e deslocar a visualização.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

object-view-box: none | <basic-shape-rect>;

object-view-box aplica-se a elementos substituídos. O valor inicial none significa que não existe uma caixa de visualização adicional; a propriedade não é herdada. Se faltar a largura ou a altura natural, não tem efeito.

<basic-shape-rect> define um retângulo relativamente às dimensões naturais do conteúdo. No exemplo, inset(0 50% 0 0) desloca o limite direito para dentro em metade da largura, selecionando assim a metade esquerda da imagem.

As dimensões da região substituem as dimensões naturais para efeitos de disposição; em seguida, object-fit e object-position atuam sobre essa região. Não se trata simplesmente de uma máscara clip-path: consoante o ajuste, o conteúdo fora da região pode continuar visível.

A especificação é um rascunho; o comportamento para uma área nula continua por definir. Verifique a apresentação no navegador de destino antes da implementação.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>object-view-box</title>
<style>
  img {
    display: block;
    width: 200px;
    height: 100px;
    object-fit: fill;
    object-view-box: inset(0 50% 0 0);
  }
</style>
<img alt="Two-color test image" width="200" height="100"
  src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='200' height='100'%3E%3Cpath fill='red' d='M0 0h100v100H0z'/%3E%3Cpath fill='blue' d='M100 0h100v100H100z'/%3E%3C/svg%3E">

Resultado

Supported rendering: a solid red 200 × 100 CSS-pixel rectangle. If the declaration is ignored: red left half and blue right half.

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