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

CKTIS / CSS

background-origin: a caixa usada para posicionar a imagem

Escolha a referência das imagens de fundo sem confundir posicionamento com recorte.

Versão: CSS Modules

Sintaxe

background-origin: content-box;

background-origin define a área de posicionamento de cada imagem de fundo. O valor inicial padding-box começa na extremidade do padding; border-box inclui o contorno e content-box começa na extremidade do conteúdo. Estas escolhas afetam background-position e a área usada pelas percentagens de background-size. Não alteram as dimensões do conteúdo, padding ou contorno do elemento. Uma lista separada por vírgulas acompanha as camadas de background-image; as listas mais curtas repetem-se e a primeira imagem é pintada sobre as seguintes.

Posicionar é diferente de pintar. background-clip determina onde o fundo continua visível, pelo que uma imagem pode ser colocada parcialmente fora da área de pintura permitida e depois recortada. Mudar apenas a origem não obriga a imagem a permanecer nessa caixa. Com background-attachment: fixed, background-origin não tem efeito: a área de posicionamento é o bloco contentor inicial. O recorte do elemento continua a ser relevante. Uma abreviatura background posterior pode repor uma origem definida anteriormente.

O exemplo cria quatro caixas, cada uma com conteúdo de 100×60px, padding de 10px e contorno transparente de 10px: o tamanho exterior é 140×100px. Uma imagem vermelha de 20×20px sem repetição em 0 0 começa nas coordenadas exteriores 0,0 com border-box, 10,10 com padding-box e 20,20 com content-box. A quarta caixa mantém o posicionamento padding-box, mas recorta para content-box: resta apenas uma parte vermelha de 10×10px a partir de 20,20. A consola indica as dimensões reais e as opções calculadas; a verificação examina separadamente os retângulos de píxeis pintados.

Exemplos

const cases = [['border-box','border-box'],['padding-box','border-box'],['content-box','border-box'],['padding-box','content-box']];
cases.forEach(([origin,clip],i)=>{
  const box=document.createElement('div');box.id='origin-'+i;
  box.style.cssText='position:absolute;top:0;width:100px;height:60px;padding:10px;border:10px solid transparent;background-image:linear-gradient(red,red);background-size:20px 20px;background-repeat:no-repeat;background-position:0 0';
  box.style.left=(i*160)+'px';box.style.backgroundOrigin=origin;box.style.backgroundClip=clip;document.body.append(box);
  const s=getComputedStyle(box),r=box.getBoundingClientRect();
  console.log(origin+'/'+clip+': '+r.width+'x'+r.height+'; '+s.backgroundOrigin+'/'+s.backgroundClip);
});

Resultado

border-box/border-box: 140x100; border-box/border-box
padding-box/border-box: 140x100; padding-box/border-box
content-box/border-box: 140x100; content-box/border-box
padding-box/content-box: 140x100; padding-box/content-box

Executado no Chromium 157.0.8103.51 com gradientes locais e verificações exatas de píxeis PNG à razão de píxeis do dispositivo 1. Abrange caixas individuais não fragmentadas, não fundos fixed, recorte arredondado ou elementos em linha fragmentados.

Fontes