Window.scrollTo()

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.

Описание

Прокрутка документа до указанных координат.

Синтаксис

window.scrollTo(x-coord, y-coord)
window.scrollTo(options)

Параметры

  • x-coord пиксель по горизонтальной оси документа, будет отображён вверху слева.

  • y-coord пиксель по вертикальной оси документа, будет отображён вверху слева.

  • options объект с тремя возможными параметрами:

    • top, то же, что и y-coord
    • left, то же, что и x-coord
    • behavior, строка, содержащая либо smooth, instant, либо auto; по умолчанию auto

Пример

js
window.scrollTo(0, 1000);

// этот код меняет поведение прокрутки на "smooth"
window.scrollTo({
  top: 1000,
  behavior: "smooth",
});

Примечания

Эта функция выполняет то же, что и window.scroll. Остальные функции, связанные с прокруткой window.scrollBy, window.scrollByLines, и window.scrollByPages.

Спецификации

Specification
CSSOM View Module
# dom-window-scrollto