WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onchange — ein change-Ereignis behandeln

Das onchange-Attribut enthält JavaScript, das bei einem change-Ereignis ausgeführt wird. Bei Formularsteuerelementen steht dieses Ereignis für eine bestätigte Änderung durch den Benutzer, nicht unbedingt für jede Bearbeitung des Werts.

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

Syntax

onchange="JavaScript statements"

onchange ist ein Event-Handler-Content-Attribut für change. Sein Wert ist der Inhalt einer JavaScript-Funktion, keine Skript-URL. Das Attribut ist bei allen HTML-Elementen verfügbar, doch allein durch das Hinzufügen wird ein Element nicht dazu gebracht, change auszulösen.

Der Zeitpunkt des Ereignisses hängt vom Steuerelement ab. Eine Checkbox löst change aus, wenn der Benutzer sie umschaltet; ein Textfeld tut dies in der Regel, wenn der geänderte Wert durch Verlassen des Feldes bestätigt wird. Verwende input, um auf laufende Bearbeitungen zu reagieren. Eine Zuweisung an .value oder .checked in JavaScript löst nicht automatisch change aus.

Im Attributcode verweist this auf das Element, das das Ereignis behandelt, und event stellt das Ereignisobjekt bereit. Das JavaScript-Gegenstück ist die Eigenschaft element.onchange; eine weitere Zuweisung ersetzt die zuvor über diesen Mechanismus registrierte Funktion. Mit element.addEventListener('change', handler) lassen sich unabhängige Listener registrieren. Eine Content Security Policy kann Attributcode blockieren. Verwende in dieser Umgebung daher ein zugelassenes Skript mit addEventListener().

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onchange example</title>
<label>
  <input type="checkbox" onchange="document.getElementById('state').textContent = this.checked ? 'ON' : 'OFF'">
  Enabled
</label>
<p id="state" role="status">OFF</p>
</html>

Ergebnis

OFF → ON → OFF

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