CKTIS / CSS
background-attachment – Verhalten des Hintergrunds beim Scrollen
Die Eigenschaft background-attachment legt fest, ob ein Hintergrundbild an die Box des Elements, an dessen scrollbaren Inhalt oder an den Viewport gebunden ist. Mögliche Werte sind scroll, local und fixed.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
background-attachment: <attachment>#;
<attachment> = scroll | fixed | localbackground-attachment steuert das Verhalten von Hintergrundbildern beim Scrollen. Der Anfangswert ist scroll; die Eigenschaft wird nicht vererbt.
scroll bindet den Hintergrund an die Box des Elements, nicht an dessen scrollbaren Inhalt. local bindet ihn an den Inhalt; die Bereiche für die Positionierung und das Zeichnen des Hintergrunds beziehen sich dann auf den scrollbaren Overflow-Bereich. fixed bindet den Hintergrund normalerweise an den Viewport, ohne das Element selbst zu fixieren. Der Hintergrund kann weiterhin zugeschnitten werden. Wird eine Transformation auf ein Element angewendet, das nicht das Wurzelelement ist, oder auf eines seiner Vorfahrenelemente, wird sein fixed-Hintergrund wie bei scroll gezeichnet. Der berechnete Wert bleibt jedoch fixed.
Für mehrere Ebenen gibst du durch Kommas getrennte Werte an, zum Beispiel background-attachment: local, scroll. Der erste Wert gehört zum ersten Bild in background-image; eine zu kurze Liste wird wiederholt. Das Beispiel vergleicht scroll und local ohne externe Ressourcen.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>background-attachment comparison</title>
<style>
body { margin: 24px; font: 16px sans-serif; }
.panel {
width: 240px;
height: 120px;
overflow: auto;
margin-bottom: 20px;
border: 2px solid black;
background-image: repeating-linear-gradient(
to bottom, #cce5ff 0 20px, #fff 20px 40px
);
}
.scroll { background-attachment: scroll; }
.local { background-attachment: local; }
.content { height: 400px; }
</style>
<h1>scroll / local</h1>
<h2>scroll</h2>
<div class="panel scroll"><div class="content">TOP</div></div>
<h2>local</h2>
<div class="panel local"><div class="content">TOP</div></div>
<script>
for (const panel of document.querySelectorAll('.panel')) {
panel.scrollTop = 30;
}
</script>
</html>Ergebnis
Both panels start with scrollTop = 30. In the scroll panel, a blue stripe starts at the inner top edge. In the local panel, a white stripe starts there. Scrolling either panel moves its content; only the local background moves with that content.
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.