background-attachment

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2022.

Die background-attachment-Eigenschaft von CSS legt fest, ob die Position eines Hintergrundbilds fest im viewport bleibt oder mit dem umgebenden Block scrollt.

Probieren Sie es aus

background-attachment: scroll;

background-attachment: fixed;

background-attachment: local;

background-attachment: local, scroll;

background-attachment: scroll, local;

<section id="default-example">
  <div id="example-element">
    London. Michaelmas term lately over, and the Lord Chancellor sitting in
    Lincoln's Inn Hall. Implacable November weather. As much mud in the streets
    as if the waters had but newly retired from the face of the earth, and it
    would not be wonderful to meet a Megalosaurus, forty feet long or so,
    waddling like an elephantine lizard up Holborn Hill. London. Michaelmas term
    lately over, and the Lord Chancellor sitting in Lincoln's Inn Hall.
    Implacable November weather. As much mud in the streets as if the waters had
    but newly retired from the face of the earth, and it would not be wonderful
    to meet a Megalosaurus, forty feet long or so, waddling like an elephantine
    lizard up Holborn Hill.
  </div>
</section>

body {
  overflow: scroll;
}

#default-example {
  height: 600px;
}

#example-element {
  max-width: 20rem;
  height: 100%;
  background:
    url("/shared-assets/images/examples/lizard.png") right 3rem top 1rem / 15rem
      no-repeat,
    url("/shared-assets/images/examples/moon.jpg") center / 10rem;
  color: #ff5454;
  font-size: 1.5em;
  font-weight: bold;
  overflow: auto;
  padding: 20px;
  text-shadow:
    0 0 0.6rem #000,
    0 0 0.6rem #000;
}

Syntax

css

/* Keyword values */
background-attachment: scroll;
background-attachment: fixed;
background-attachment: local;

/* Global values */
background-attachment: inherit;
background-attachment: initial;
background-attachment: revert;
background-attachment: revert-layer;
background-attachment: unset;

Die background-attachment-Eigenschaft wird als eines der Schlüsselwortwerte aus der unten stehenden Liste angegeben.

Werte

fixed: Der Hintergrund ist relativ zum Viewport festgesetzt. Auch wenn ein Element einen Scrollmechanismus hat, bewegt sich der Hintergrund nicht mit dem Element.
local: Der Hintergrund ist relativ zum Inhalt des Elements festgesetzt. Wenn das Element einen Scrollmechanismus hat, scrollt der Hintergrund mit dem Inhalt des Elements, und der Bereich für die Hintergrundmalerei sowie der Bereich für die Hintergrundpositionierung beziehen sich auf den scrollbaren Bereich des Elements und nicht auf den Rahmen, der sie umgibt.
scroll: Der Hintergrund ist relativ zum Element selbst festgesetzt und scrollt nicht mit seinem Inhalt. (Er ist im Wesentlichen an den Rahmen des Elements gebunden.)

Formale Definition

Anfangswert	`scroll`
Anwendbar auf	alle Elemente. Auch anwendbar auf `::first-letter` und `::first-line`.
Vererbt	Nein
Berechneter Wert	wie angegeben
Animationstyp	diskret

Formale Syntax

background-attachment = 
  <attachment>#  

<attachment> = 
  scroll  |
  fixed   |
  local

Beispiele

Einfaches Beispiel

HTML

html

<p>
  There were doors all round the hall, but they were all locked; and when Alice
  had been all the way down one side and up the other, trying every door, she
  walked sadly down the middle, wondering how she was ever to get out again.
</p>

CSS

css

p {
  background-image: url("star-solid.gif");
  background-attachment: fixed;
}

Ergebnis

Diese Eigenschaft unterstützt mehrere Hintergrundbilder. Für jedes Hintergrundbild kann ein anderes <attachment> angegeben werden, getrennt durch Kommata. Jedes Bild wird mit dem entsprechenden <attachment>-Typ von zuerst angegeben bis zuletzt abgeglichen.

HTML

html

<p>
  There were doors all round the hall, but they were all locked; and when Alice
  had been all the way down one side and up the other, trying every door, she
  walked sadly down the middle, wondering how she was ever to get out again.
  Suddenly she came upon a little three-legged table, all made of solid glass;
  there was nothing on it except a tiny golden key, and Alice's first thought
  was that it might belong to one of the doors of the hall; but, alas! either
  the locks were too large, or the key was too small, but at any rate it would
  not open any of them. However, on the second time round, she came upon a low
  curtain she had not noticed before, and behind it was a little door about
  fifteen inches high: she tried the little golden key in the lock, and to her
  great delight it fitted!
</p>

CSS

css

p {
  background-image: url("star-solid.gif"), url("star-transparent.gif");
  background-attachment: fixed, scroll;
  background-repeat: no-repeat, repeat-y;
}

Ergebnis

Spezifikationen

Specification
CSS Backgrounds and Borders Module Level 3 # the-background-attachment

Browser-Kompatibilität

Siehe auch

Verwendung mehrerer Hintergründe