Element.scrollTop

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

La propiedad Element.scrollTop obtiene o establece el número de pixels que el contenido de un elemento ha sido desplazado (enrollado) hacia arriba. El scrollTop de un elemento es una medida de la distancia desde el límite superior de un elemento al límite superior de su contenido visible. Cuando un elemento no genera una barra de scroll vertical, el valor de su scrollTop es establecido por defecto a 0.

Sintaxis

js
// Obtiene el número de pixels desplazados
var intElemScrollTop = someElement.scrollTop;

Después de ejecutar este código, intElemScrollTop es un entero que corresponde al número de pixesl que el contenido del element ha sido desplazado hacia arriba.

js
// Establece el número de pixels desplazados
element.scrollTop = intValue;

scrollTop puede ser establecido a cualquier valor entero, con ciertas salvedades:

  • Si el elemento no puede ser desplazado (p.e. no tiene desbordamiento (overflow) o si el elemento no es desplazable (non-scrollable), scrollTop es establecido a 0.
  • Si se asigna un valor menor que 0, scrollTop es establecido a 0.
  • Si se asigna un valor mayor que el máximo al que el contenido puede ser desplazado, scrollTop es establecido al valor máximo.

Ejemplo

must be provided

Image:scrollTop.png

Especificaciones

Specification
CSSOM View Module
# dom-element-scrolltop

Compatibilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
scrollTop

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Referencias