Element: scrollIntoViewIfNeeded()-Methode

Nicht standardisiert: Diese Funktion ist nicht standardisiert und befindet sich nicht auf dem Weg zur Standardisierung. Verwenden Sie sie nicht auf Produktionsseiten, die dem Web ausgesetzt sind: Sie funktioniert nicht für alle Benutzer. Es kann auch große Inkompatibilitäten zwischen Implementierungen geben, und das Verhalten kann sich in Zukunft ändern.

Die Methode Element.scrollIntoViewIfNeeded() scrollt das aktuelle Element in den sichtbaren Bereich des Browser-Fensters, wenn es sich nicht bereits innerhalb dieses Bereichs befindet. Sollte sich das Element bereits im sichtbaren Bereich befinden, wird nicht gescrollt. Diese Methode ist eine proprietäre Variation der standardisierten Element.scrollIntoView()-Methode.

Syntax

js
scrollIntoViewIfNeeded()
scrollIntoViewIfNeeded(centerIfNeeded)

Parameter

centerIfNeeded Optional

Ein optionaler boolescher Wert mit einem Standardwert von true:

  • Wenn true, wird das Element so ausgerichtet, dass es zentriert innerhalb des sichtbaren Bereichs des scrollbareren Vorfahren ist.
  • Wenn false, wird das Element an der nächstgelegenen Kante des sichtbaren Bereichs des scrollbareren Vorfahren ausgerichtet. Abhängig davon, welche Kante des sichtbaren Bereichs dem Element näher ist, wird entweder die obere Kante des Elements an die obere Kante des sichtbaren Bereichs ausgerichtet, oder die untere Kante des Elements wird an die untere 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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
scrollIntoViewIfNeeded
Non-standard

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Non-standard. Check cross-browser support before using.
See implementation notes.

Siehe auch