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

No specification found

No specification data found for api.HTMLElement.load_event.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

  • Verwandte Ereignisse

    • Window: load Ereignis
    • Window: error Ereignis