Элемент: метод scrollIntoViewIfNeeded()

Нестандартный: Эта функция нестандартна и не включена в стандарты. Не используйте её на веб-сайтах, предназначенных для широкой аудитории: она не будет работать для всех пользователей. Также могут существовать значительные несовместимости между реализациями, и поведение может измениться в будущем.

Метод Element.scrollIntoViewIfNeeded() прокручивает текущий элемент в видимую область окна браузера, если он ещё не находится в видимой области окна браузера. Если элемент уже находится в видимой области окна браузера, прокрутка не выполняется. Этот метод является фирменным вариантом стандартного метода Element.scrollIntoView().

Синтаксис

scrollIntoViewIfNeeded()
scrollIntoViewIfNeeded(centerIfNeeded)

Параметры

centerIfNeeded Необязательно

Необязательное булево значение по умолчанию true:

Если true, элемент будет выровнен по центру видимой области родительского элемента со скроллингом.
Если false, элемент будет выровнен по ближайшему краю видимой области родительского элемента со скроллингом. В зависимости от того, какой край видимой области ближе к элементу, либо верхняя часть элемента будет выровнена с верхним краем видимой области, либо нижняя часть элемента — с нижним краем видимой области.

Возвращаемое значение

None (undefined).

Примеры

const element = document.getElementById("my-el");

element.scrollIntoViewIfNeeded(); // Centers the element in the visible area
element.scrollIntoViewIfNeeded(false); // Aligns the element to the nearest edge in the visible area

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

Не входит ни в одну спецификацию. Это фирменный, специфичный для WebKit метод.

Совместимость с браузерами

	Рабочий стол					Мобильные
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`scrollIntoViewIfNeeded`	1	79	Нет	15	3	18	Нет	14	1	1.0	4.4

См. также

Ошибка W3C CSSOM 17152: Поддержка центрирования элемента при прокрутке в область видимости. (запрос на добавление в стандарт эквивалента scrollIntoViewIfNeeded)

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollIntoViewIfNeeded