Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

background-origin: la caja usada para colocar la imagen

Elige la referencia de las imágenes de fondo sin confundir su posición con su recorte.

Versión: CSS Modules

Sintaxis

background-origin: content-box;

background-origin define el área de posicionamiento de cada imagen de fondo. El valor inicial padding-box empieza en el borde del relleno; border-box incluye el borde y content-box empieza en el borde del contenido. La elección afecta a background-position y al área usada por los porcentajes de background-size. No modifica las dimensiones del contenido, el relleno ni el borde del elemento. Una lista separada por comas sigue las capas de background-image; las listas más cortas se repiten y la primera imagen se pinta sobre las siguientes.

Posicionar no es lo mismo que pintar. background-clip determina dónde sigue visible el fondo, por lo que una imagen puede colocarse parcialmente fuera de su área de pintura permitida y después recortarse. Cambiar solo el origen no obliga a la imagen a permanecer dentro de esa caja. Con background-attachment: fixed, background-origin no tiene efecto: el área de posicionamiento es el bloque contenedor inicial. El recorte del elemento sigue importando. Una abreviatura background posterior puede restablecer el origen definido antes.

El ejemplo crea cuatro cajas, cada una con contenido de 100×60px, relleno de 10px y borde transparente de 10px: su tamaño exterior es 140×100px. Una imagen roja de 20×20px sin repetición en 0 0 empieza en las coordenadas exteriores 0,0 con border-box, 10,10 con padding-box y 20,20 con content-box. La cuarta mantiene padding-box para posicionar, pero recorta a content-box: solo queda una porción roja de 10×10px desde 20,20. La consola informa de dimensiones reales y opciones calculadas; la verificación comprueba por separado los rectángulos de píxeles pintados.

Ejemplos

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

Ejecutado en Chromium 157.0.8103.51 con degradados locales y comprobaciones exactas de píxeles PNG a una relación de píxeles del dispositivo de 1. Cubre cajas individuales sin fragmentar, no fondos fixed, recorte redondeado ni elementos en línea fragmentados.

Fuentes