Window: load-Event

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Das load-Ereignis wird ausgelöst, wenn die gesamte Seite geladen wurde, einschließlich aller abhängigen Ressourcen wie Stylesheets, Skripte (einschließlich asynchroner, verzögerter und Modulscripte), iframes und Bilder, mit Ausnahme derer, die lazy geladen werden. Dies steht im Gegensatz zu DOMContentLoaded, das ausgelöst wird, sobald der DOM der Seite geladen ist, ohne darauf zu warten, dass Ressourcen vollständig geladen sind.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht gebubbelt.

Hinweis: Alle Ereignisse mit dem Namen load werden nicht zum Window propagiert, selbst wenn bubbles auf true gesetzt ist. Um load-Ereignisse im window zu erfassen, muss dieses load-Ereignis direkt an das window gesendet werden.

Hinweis: Das load-Ereignis, das ausgelöst wird, wenn das Hauptdokument geladen wurde, wird im window ausgelöst, aber es hat zwei veränderte Eigenschaften: target ist document, und path ist undefined. Diese beiden Eigenschaften sind aufgrund der Kompatibilität mit älteren Versionen verändert.

Um zu vermeiden, dass ein Skript ausgeführt wird, bevor der vom Skript manipulierte DOM vollständig erstellt wurde, können Sie das Skript am Ende des body-Dokuments platzieren, direkt vor dem schließenden </body>-Tag, ohne es in einen Ereignislistener zu wickeln. Normalerweise sollten Sie das load-Ereignis nur verwenden, um auf das Laden externer Ressourcen wie Bilder oder verzögerte Skripte zu warten.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder legen Sie eine Ereignisbehandlungseigenschaft fest.

addEventListener("load", (event) => { })

onload = (event) => { }

Ereignistyp

Ein generisches Event.

Beispiele

Eine Nachricht ausgeben, wenn die Seite vollständig geladen ist:

window.addEventListener("load", (event) => {
  console.log("page is fully loaded");
});

Dasselbe, aber mit der onload-Ereignisbehandlungseigenschaft:

window.onload = (event) => {
  console.log("page is fully loaded");
};

Live-Beispiel

HTML

html

<div class="controls">
  <button id="reload" type="button">Reload</button>
</div>

<div class="event-log">
  <label for="eventLog">Event log:</label>
  <textarea
    readonly
    class="event-log-contents"
    rows="8"
    cols="30"
    id="eventLog"></textarea>
</div>

body {
  display: grid;
  grid-template-areas: "control log";
}

.controls {
  grid-area: control;
  display: flex;
  align-items: center;
  justify-content: center;
}

.event-log {
  grid-area: log;
}

.event-log-contents {
  resize: none;
}

label,
button {
  display: block;
}

#reload {
  height: 2rem;
}

JavaScript

const log = document.querySelector(".event-log-contents");
const reload = document.querySelector("#reload");

reload.addEventListener("click", () => {
  log.textContent = "";
  setTimeout(() => {
    window.location.reload(true);
  }, 200);
});

window.addEventListener("load", (event) => {
  log.textContent += "load\n";
});

document.addEventListener("readystatechange", (event) => {
  log.textContent += `readystate: ${document.readyState}\n`;
});

document.addEventListener("DOMContentLoaded", (event) => {
  log.textContent += `DOMContentLoaded\n`;
});

Ergebnis

Spezifikationen

Spezifikation
UI Events # event-type-load
HTML # delay-the-load-event

Browser-Kompatibilität

Siehe auch

Document readyState API
Verwandte Ereignisse:

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden