WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onload – das load-Ereignis behandeln

Das Attribut onload enthält JavaScript zur Behandlung des load-Ereignisses. Auf dem body-Element bezieht es sich auf das Laden der Seite und behandelt das Ereignis des Window-Objekts, nicht ein Ereignis des body-Elements selbst.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

onload="JavaScript statements"

onload ist ein Event-Handler-Inhaltsattribut für load. Sein Wert ist der Funktionskörper in JavaScript, nicht die Adresse einer Skriptdatei. Das Hinzufügen des Attributs startet nicht selbst das Laden einer Ressource.

Auf dem body-Element behandelt onload das Ereignis des Window-Objekts. Es bedeutet daher nicht nur, dass das body-Element bereit ist. Das Seitenereignis tritt ein, nachdem das Parsen abgeschlossen ist und Faktoren, die das Laden der Seite verzögern, weggefallen sind; DOMContentLoaded tritt in diesem Ablauf früher auf und ist kein gleichwertiger Ersatz.

Der Attributcode ist ausführbares JavaScript: Füge keine nicht vertrauenswürdigen Daten darin ein. Content Security Policy kann diese Inline-Handler blockieren.

Das Beispiel ändert nach dem Laden der Seite den Absatztext von Waiting zu Loaded. Es ruft keine externen Ressourcen ab. Speichere es als HTML-Datei und öffne es in einem Browser mit aktiviertem JavaScript und ohne Richtlinie, die Inline-Handler blockiert.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>onload example</title>
</head>
<body onload="document.getElementById('status').textContent = 'Loaded'">
  <p id="status">Waiting</p>
</body>
</html>

Ergebnis

Loaded

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen