HTMLElement: load Ereignis

Das load Ereignis wird für Elemente ausgelöst, die eine Ressource enthalten, wenn die Ressource erfolgreich geladen wurde. Zu den derzeit unterstützten HTML-Elementen gehören: <body>, <embed>, <iframe>, <img>, <link>, <object>, <script>, <style> und <track>.

Hinweis: Das load Ereignis auf dem HTMLBodyElement ist tatsächlich ein Alias für das window.onload Ereignis. Daher wird das load Ereignis am <body> Element nur ausgelöst, wenn alle Ressourcen des Dokuments geladen oder fehlgeschlagen sind. Aus Klarheitsgründen wird empfohlen, den Ereignishandler direkt an das window Objekt anzuhängen, anstatt an HTMLBodyElement.

Dieses Ereignis kann nicht abgebrochen werden und propagiert nicht.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

js
elt.addEventListener("load", (event) => { ... });
// or
elt.onload = (event) => { ... };

Ereignistyp

Ein generisches Event.

Beispiele

Dieses Beispiel gibt eine Meldung auf dem Bildschirm aus, wenn das <img> Element seine Ressource erfolgreich lädt.

HTML

html
<img id="image" src="favicon144.png" alt="MDN logo" width="72" />
<div><button onclick="reload()">Reload</button></div>

JavaScript

js
const image = document.getElementById("image");
image.onload = () => {
  document.body.appendChild(document.createElement("div")).textContent =
    "loaded!";
};

function reload() {
  image.src = "favicon144.png";
}

Ergebnis

Spezifikationen

Specification
UI Events
# event-type-load
HTML
# handler-onload
HTML
# event-load

Browser-Kompatibilität

Siehe auch

  • Verwandte Ereignisse

    • Window: load Ereignis
    • Window: error Ereignis