Element.scrollIntoView()

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.

The Element.scrollIntoView() method scrolls the current element into the visible area of the browser window.

Syntax

JavaScript
element.scrollIntoView(); // Equivalent to element.scrollIntoView(true)
element.scrollIntoView(<var>alignToTop</var>); // Boolean arguments
element.scrollIntoView(<var>scrollIntoViewOptions</var>); // Object argument

Parameters

alignToTop
Is a Boolean value:
  • If true, the top of the element will be aligned to the top of the visible area of the scrollable ancestor.
  • If false, the bottom of the element will be aligned to the bottom of the visible area of the scrollable ancestor.
scrollIntoViewOptions
A boolean or an object with the following options:
JavaScript
{
  behavior: "auto"  | "instant" | "smooth",
  block:    "start" | "end",
}
If it is a boolean, true corresponds to {block: "start"} and false to {block: "end"}

Example

JavaScript
var element = document.getElementById("box");

element.scrollIntoView();
element.scrollIntoView(false);
element.scrollIntoView({block: "end"});
element.scrollIntoView({block: "end", behavior: "smooth"});

Notes

The element may not be scrolled completely to the top or bottom depending on the layout of other elements.

Specifications

Specification Status Comment
CSS Object Model (CSSOM) View Module
The definition of 'Element.scrollIntoView()' in that specification.
Working Draft Initial definition

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 29[1] 1.0 (1.7 or earlier) 8[1] 38[1] 9.1[1]
scrollIntoViewOptions No support 36 (36) No support No support No support
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 4.3[1] 1.0 (1.0) ? No support 9.1[1]
scrollIntoViewOptions No support 36.0 (36) ? No support No support

[1] Supports scrollIntoView with boolean parameter, but not smooth behavior option

See also

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/element/scrollintoview

API CSSOM Views Experimental Expérimental Method Reference Référence