Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

background-attachment — comportement de l’arrière-plan pendant le défilement

La propriété background-attachment détermine si une image d’arrière-plan est attachée à la boîte de l’élément, à son contenu défilant ou à la fenêtre d’affichage. Ses valeurs sont scroll, local et fixed.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

background-attachment: <attachment>#;
<attachment> = scroll | fixed | local

background-attachment contrôle le comportement des images d’arrière-plan pendant le défilement. Sa valeur initiale est scroll ; la propriété n’est pas héritée.

scroll attache l’arrière-plan à la boîte de l’élément, et non à son contenu défilant. local l’attache au contenu ; les zones de positionnement et de peinture de l’arrière-plan se rapportent alors à la zone de débordement défilante. fixed attache normalement l’arrière-plan à la fenêtre d’affichage sans fixer l’élément lui-même. L’arrière-plan reste soumis au découpage. Si une transformation s’applique à un élément autre que l’élément racine ou à l’un de ses ancêtres, son arrière-plan fixed est peint comme avec scroll, mais la valeur calculée reste fixed.

Pour plusieurs calques, indiquez des valeurs séparées par des virgules, par exemple background-attachment: local, scroll. La première correspond à la première image de background-image ; une liste trop courte est répétée. L’exemple compare scroll et local sans ressources externes.

Exemples

<!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>

Résultat

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.

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources