NavigateEvent: scroll()-Methode
Baseline 2026
Neu verfügbar
Seit Januar 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die scroll()-Methode der NavigateEvent-Schnittstelle kann aufgerufen werden, um das vom Browser gesteuerte Scrollverhalten, das als Antwort auf die Navigation auftritt, manuell auszulösen, falls Sie möchten, dass es vor dem Abschluss der Navigationsverarbeitung geschieht.
Syntax
scroll()
Parameter
Keine.
Rückgabewert
Kein Wert (undefined).
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn das aktuelle
Documentnoch nicht aktiv ist oder wenn die Navigation abgebrochen wurde. SecurityErrorDOMException-
Wird ausgelöst, wenn das Event durch einen
dispatchEvent()-Aufruf statt durch den User-Agent ausgelöst wurde.
Beispiele
Scroll-Verhalten mit scroll() handhaben
In diesem Beispiel zur Abfangung einer Navigation beginnt die handler()-Funktion damit, einen Artikelinhalt abzurufen und darzustellen, und ruft dann danach noch einige sekundäre Inhalte ab und stellt diese dar. Es macht Sinn, die Seite zum Hauptartikelinhalt zu scrollen, sobald dieser verfügbar ist, damit der Benutzer mit diesem interagieren kann, anstatt zu warten, bis auch die sekundären Inhalte gerendert sind. Um dies zu erreichen, haben wir einen scroll()-Aufruf zwischen die beiden hinzugefügt.
navigation.addEventListener("navigate", (event) => {
if (shouldNotIntercept(navigateEvent)) {
return;
}
const url = new URL(event.destination.url);
if (url.pathname.startsWith("/articles/")) {
event.intercept({
async handler() {
const articleContent = await getArticleContent(url.pathname);
renderArticlePage(articleContent);
event.scroll();
const secondaryContent = await getSecondaryContent(url.pathname);
addSecondaryContent(secondaryContent);
},
});
}
});
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-navigateevent-scroll-dev |