Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

background-attachment — comportamento dello sfondo durante lo scorrimento

La proprietà background-attachment determina se un’immagine di sfondo è associata al riquadro dell’elemento, al suo contenuto scorrevole o alla finestra di visualizzazione. I suoi valori sono scroll, local e fixed.

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

Sintassi

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

background-attachment controlla il comportamento delle immagini di sfondo durante lo scorrimento. Il valore iniziale è scroll; la proprietà non è ereditata.

scroll associa lo sfondo al riquadro dell’elemento, ma non al suo contenuto scorrevole. local lo associa al contenuto; le aree di posizionamento e di disegno dello sfondo si riferiscono quindi all’area di overflow scorrevole. fixed associa normalmente lo sfondo alla finestra di visualizzazione senza fissare l’elemento stesso. Lo sfondo resta soggetto al ritaglio. Se una trasformazione è applicata a un elemento diverso dall’elemento radice o a uno dei suoi antenati, lo sfondo fixed di quell’elemento viene disegnato come se il valore fosse scroll, ma il valore calcolato rimane fixed.

Per più livelli, indica valori separati da virgole, ad esempio background-attachment: local, scroll. Il primo corrisponde alla prima immagine in background-image; se l’elenco è troppo breve, viene ripetuto. L’esempio confronta scroll e local senza risorse esterne.

Esempi

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

Risultato

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.

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti