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

Image:scrollTop.png

Especificaciones

Specification
CSSOM View Module
# dom-element-scrolltop

Compatibilidad con navegadores

Referencias