CKTIS / CSS
background-origin : la boîte de référence pour positionner l’image
Choisissez la référence des images de fond sans confondre leur positionnement avec leur découpage.
Version : CSS Modules
Syntaxe
background-origin: content-box;background-origin définit la zone de positionnement de chaque image de fond. La valeur initiale padding-box commence au bord du padding ; border-box inclut la bordure, tandis que content-box commence au bord du contenu. Ces choix affectent background-position et la zone de référence des pourcentages de background-size. Ils ne changent pas les dimensions du contenu, du padding ou de la bordure. Une liste séparée par des virgules suit les couches de background-image ; les listes plus courtes se répètent et la première image est peinte au-dessus des suivantes.
Positionner et peindre sont deux choses distinctes. background-clip détermine où le fond reste visible : une image peut être placée en partie hors de sa zone de peinture autorisée, puis découpée. Changer l’origine ne force pas à lui seul l’image à rester dans cette boîte. Avec background-attachment: fixed, background-origin n’a aucun effet : la zone de positionnement est le bloc conteneur initial. Le découpage de l’élément reste pertinent. Un raccourci background ultérieur peut réinitialiser une origine définie auparavant.
L’exemple crée quatre boîtes contenant chacune 100×60px de contenu, 10px de padding et une bordure transparente de 10px : leur taille extérieure est 140×100px. Une image rouge de 20×20px, non répétée et placée à 0 0, commence aux coordonnées extérieures 0,0 avec border-box, 10,10 avec padding-box et 20,20 avec content-box. La quatrième boîte conserve padding-box pour la position mais découpe à content-box : seule une portion rouge de 10×10px commençant à 20,20 reste visible. La console indique les dimensions réelles et les choix calculés ; la vérification inspecte séparément les rectangles de pixels peints.
Exemples
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);
});Résultat
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
Exécuté dans Chromium 157.0.8103.51 avec des dégradés locaux et des contrôles exacts des pixels PNG à un rapport de pixels de l’appareil de 1. Le cas couvre des boîtes uniques non fragmentées, pas les fonds fixed, le découpage arrondi ou les éléments en ligne fragmentés.