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.