Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

background-attachment — comportamento do fundo durante a deslocação

A propriedade background-attachment determina se uma imagem de fundo está associada à caixa do elemento, ao seu conteúdo deslocável ou à janela de visualização. Os valores são scroll, local e fixed.

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

Sintaxe

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

background-attachment controla o comportamento das imagens de fundo durante a deslocação. O valor inicial é scroll; a propriedade não é herdada.

scroll associa o fundo à caixa do elemento, mas não ao seu conteúdo deslocável. local associa-o ao conteúdo; as áreas de posicionamento e de pintura do fundo passam então a referir-se à área de overflow deslocável. fixed associa normalmente o fundo à janela de visualização sem fixar o próprio elemento. O fundo continua sujeito a recorte. Se for aplicada uma transformação a um elemento que não seja o elemento raiz ou a qualquer um dos seus antepassados, o fundo fixed desse elemento é pintado como se o valor fosse scroll, mas o valor calculado mantém-se fixed.

Para várias camadas, indica valores separados por vírgulas, como background-attachment: local, scroll. O primeiro corresponde à primeira imagem em background-image; uma lista demasiado curta é repetida. O exemplo compara scroll e local sem recursos externos.

Exemplos

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

Resultado

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.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes