Element: scrollIntoViewIfNeeded() Methode

Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

Die Element.scrollIntoViewIfNeeded() Methode scrollt das aktuelle Element in den sichtbaren Bereich des Browserfensters, wenn es sich nicht bereits im sichtbaren Bereich des Browserfensters befindet. Wenn das Element bereits im sichtbaren Bereich des Browserfensters ist, findet kein Scrollen statt. Diese Methode ist eine proprietäre Variante der standardisierten Element.scrollIntoView() Methode.

Syntax

js
scrollIntoViewIfNeeded()
scrollIntoViewIfNeeded(centerIfNeeded)

Parameter

centerIfNeeded Optional

Ein optionaler boolescher Wert mit dem Standardwert true:

  • Wenn true, wird das Element so ausgerichtet, dass es zentriert im sichtbaren Bereich des scrollbaren Vorfahren ist.
  • Wenn false, wird das Element an der nächstgelegenen Kante des sichtbaren Bereichs des scrollbaren Vorfahren ausgerichtet. Abhängig davon, welche Kante des sichtbaren Bereichs dem Element am nächsten ist, wird entweder der obere Teil des Elements an der oberen Kante des sichtbaren Bereichs ausgerichtet, oder die untere Kante des Elements wird an der unteren Kante des sichtbaren Bereichs ausgerichtet.

Rückgabewert

Keiner (undefined).

Beispiele

js
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

Spezifikationen

Nicht Teil einer Spezifikation. Dies ist eine proprietäre, WebKit-spezifische Methode.

Browser-Kompatibilität

Siehe auch