WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

background-origin: die Bezugsbox für die Bildposition

Wähle die Bezugsbox für Hintergrundbilder und unterscheide Positionierung vom Beschneiden.

Version: CSS Modules

Syntax

background-origin: content-box;

background-origin bestimmt den Positionierungsbereich jedes Hintergrundbildes. Der Anfangswert padding-box beginnt an der Padding-Kante; border-box schließt den Rahmen ein, content-box beginnt an der Inhaltskante. Diese Auswahl beeinflusst background-position und die Bezugsfläche für prozentuales background-size. Sie verändert weder Inhalt noch Padding- oder Rahmenmaße des Elements. Eine kommagetrennte Liste folgt den background-image-Ebenen; kürzere Listen wiederholen sich, und das erste Bild wird über späteren Bildern gezeichnet.

Positionierung und Zeichenbereich sind verschieden. background-clip legt fest, wo der Hintergrund sichtbar bleibt. Ein Bild kann deshalb teilweise außerhalb seines erlaubten Zeichenbereichs positioniert und anschließend beschnitten werden. Ein anderer Ursprung zwingt das Bild allein nicht, innerhalb dieser Box zu bleiben. Bei background-attachment: fixed hat background-origin keine Wirkung: Der Positionierungsbereich ist der anfängliche umschließende Block. Das Beschneiden am Element bleibt relevant. Eine spätere background-Kurzschreibweise kann einen zuvor festgelegten Ursprung zurücksetzen.

Das Beispiel erzeugt vier Boxen mit jeweils 100×60px Inhalt, 10px Padding und einem transparenten 10px-Rahmen; außen messen sie 140×100px. Ein nicht wiederholtes rotes Bild von 20×20px bei 0 0 beginnt in äußeren Koordinaten bei 0,0 mit border-box, 10,10 mit padding-box und 20,20 mit content-box. Die vierte Box positioniert weiterhin relativ zu padding-box, beschneidet aber auf content-box: Sichtbar bleibt nur ein rotes Stück von 10×10px ab 20,20. Die Konsole meldet tatsächliche Boxmaße und berechnete Einstellungen; die Prüfung untersucht separat die gezeichneten Pixelrechtecke.

Beispiele

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);
});

Ergebnis

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

Ausgeführt in Chromium 157.0.8103.51 mit lokalen Farbverläufen und exakten PNG-Pixelprüfungen bei Gerätepixelverhältnis 1. Geprüft werden einzelne unfragmentierte Boxen, nicht fixed-Hintergründe, abgerundetes Beschneiden oder fragmentierte Inline-Elemente.

Quellen