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

CKTIS / CSS

scroll-behavior — comportamento de deslocação

A propriedade scroll-behavior determina se a deslocação iniciada pela navegação ou por uma API é instantânea ou suave. Não controla a deslocação direta do utilizador.

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

Sintaxe

scroll-behavior: auto | smooth;

scroll-behavior aplica-se a contentores com deslocação. O valor inicial auto significa uma deslocação instantânea; smooth significa um movimento cuja duração e evolução são definidas pelo navegador. A propriedade não é herdada nem animável.

Abrange a navegação, as APIs de deslocação e as operações de ajuste da deslocação que não sejam iniciadas pelo utilizador. Não altera a deslocação direta por gestos ou pela roda do rato. Em html, controla a área de visualização da página; defini-la em body não a propaga para essa área. Os navegadores podem ignorar a propriedade.

No exemplo, overflow: auto e uma altura limitada criam um contentor com deslocação. A chamada a scrollTo() com behavior: 'auto' consulta o valor calculado de scroll-behavior, pelo que pode iniciar um movimento suave. Isto não é o mesmo que CSS scroll-behavior: auto. Verifique a posição final, não uma duração fixa da animação.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>scroll-behavior</title>
<style>
  #panel {
    height: 120px;
    overflow: auto;
    scroll-behavior: smooth;
    border: 1px solid;
  }
  #content { height: 600px; }
</style>
<button id="go" type="button">Scroll to 240px</button>
<div id="panel" tabindex="0" aria-label="Scrollable example">
  <div id="content">Scrollable content</div>
</div>
<script>
  const panel = document.getElementById('panel');
  document.getElementById('go').addEventListener('click', () => {
    panel.scrollTo({ top: 240, behavior: 'auto' });
  });
</script>
</html>

Resultado

After scrolling completes without interruption: panel.scrollTop === 240. No console output.

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