WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

Das onclick-Attribut

Das onclick-Attribut enthält JavaScript-Code zur Behandlung eines click-Ereignisses. Es ist von der Eigenschaft element.onclick zu unterscheiden.

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

Syntax

onclick="JavaScript statements"

Alle HTML-Elemente unterstützen onclick. Sein Wert ist der Inhalt einer JavaScript-Funktion, keine URL. Der Code wird ausgeführt, wenn ein click-Ereignis behandelt wird.

Im Attribut bezeichnet event das Ereignis und this das behandelnde Element, nicht zwingend event.target. Das Textattribut onclick und die Eigenschaft element.onclick, die eine Funktion oder null akzeptiert, steuern denselben Handler-Platz. Wird eine Funktion zugewiesen, ersetzt sie den vorherigen Handler.

return false bricht das Ereignis ab, sofern es abbrechbar ist; die Weitergabe wird dadurch nicht gestoppt. Eine Content Security Policy kann Code im Attribut blockieren. Füge keine nicht vertrauenswürdigen Inhalte darin ein.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>onclick example</title>
</head>
<body>
  <button type="button" onclick="this.textContent = 'Done';">Run</button>
</body>
</html>

Ergebnis

Done

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