Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

scroll-behavior — comportamiento del desplazamiento

La propiedad scroll-behavior determina si el desplazamiento iniciado por la navegación o una API es instantáneo o suave. No controla el desplazamiento directo realizado por el usuario.

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

Sintaxis

scroll-behavior: auto | smooth;

scroll-behavior se aplica a los contenedores desplazables. El valor inicial auto significa que el desplazamiento es instantáneo; smooth indica un movimiento cuya duración y evolución define el navegador. La propiedad no se hereda ni es animable.

Abarca la navegación, las API de desplazamiento y las operaciones de ajuste del desplazamiento que no inicia el usuario. No cambia el desplazamiento directo mediante gestos o la rueda. En html, controla la ventana gráfica de la página; establecerla en body no la propaga a esa ventana. Los navegadores pueden ignorar la propiedad.

En el ejemplo, overflow: auto y una altura limitada crean un contenedor desplazable. La llamada a scrollTo() con behavior: 'auto' consulta el valor calculado de scroll-behavior, por lo que puede iniciar un movimiento suave. Esto no es lo mismo que CSS scroll-behavior: auto. Comprueba la posición final, no una duración fija de la animación.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes