Element: scrollIntoViewIfNeeded()-Methode
Kein Standard: Diese Funktion ist nicht standardisiert und befindet sich nicht im Standardisierungsprozess. Verwenden Sie sie nicht auf Produktionsseiten, die auf das Web ausgerichtet sind: Sie wird nicht für alle Benutzer funktionieren. Außerdem kann es 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
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.
- Wenn
Rückgabewert
Keiner (undefined
).
Beispiele
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
BCD tables only load in the browser
Siehe auch
- W3C CSSOM Fehler 17152: Unterstützung für das Zentrieren eines Elements beim Scrollen in den sichtbaren Bereich. (Feature-Request für ein standardisiertes Äquivalent zu
scrollIntoViewIfNeeded
)