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.