CKTIS / HTML
oninput — das input-Ereignis behandeln
Das Attribut oninput enthält JavaScript-Code, der beim input-Ereignis ausgeführt wird. Bei einem Textfeld können Sie so auf Änderungen durch Nutzer reagieren, ohne darauf zu warten, dass sie das Feld verlassen.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
oninput="JavaScript statements"oninput ist ein Event-Handler-Content-Attribut für input, das auf allen HTML-Elementen verfügbar ist. Sein Wert ist der Funktionsrumpf in JavaScript, nicht lediglich ein Ereignisname oder eine Funktionsdeklaration. Dass das Attribut verfügbar ist, bedeutet nicht, dass jedes Element diese Ereignisse selbst auslöst.
Bei einem Textfeld signalisiert input Änderungen des Werts durch Nutzer, etwa durch Tippen, Einfügen oder Löschen von Text. Anders als change wartet es nicht darauf, dass die Bearbeitung abgeschlossen ist; bei einem Textfeld geschieht das üblicherweise, wenn der Fokus das Feld verlässt. Eine Zuweisung an value in JavaScript löst input nicht automatisch aus.
Im Code des Attributs verweist this auf das Element, das das Ereignis verarbeitet, und event stellt das Ereignisobjekt bereit. Außerdem gibt es die JavaScript-Eigenschaft element.oninput: Wird ihr eine Funktion zugewiesen, ersetzt diese die bisherige Funktion dieses Handlers; bei einer Zuweisung von null wird der Handler deaktiviert.
Das Beispiel kopiert den aktuellen Wert von this.value in textContent des Ergebniselements. Die Content Security Policy (CSP) kann Inline-Code blockieren; damit das Beispiel ausgeführt werden kann, müssen Inline-Event-Handler erlaubt sein.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oninput example</title>
<label>Text: <input type="text" oninput="document.getElementById('result').textContent = this.value"></label>
<p>Value: <output id="result"></output></p>
</html>Ergebnis
Value: abc
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.