CKTIS / HTML
onbeforeinput — Ereignis vor der Bearbeitung behandeln
onbeforeinput ist ein Ereignisbehandlungsattribut für beforeinput, das die Bearbeitung von Daten durch Benutzer betrifft. Damit kann JavaScript vor einer Änderung ausgeführt und der Standardvorgang abgebrochen werden, wenn das Ereignis abbrechbar ist.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onbeforeinput="JavaScript statements"
element.onbeforeinput = function (event) { /* ... */ };onbeforeinput ist ein HTML-Attribut, das Handler-Code für das Ereignis beforeinput enthält. Es ist auf allen HTML-Elementen verfügbar; allein durch das Hinzufügen wird ein Element nicht bearbeitbar. Das JavaScript-Gegenstück dazu ist die Eigenschaft element.onbeforeinput.
Im Attributcode bezieht sich event auf das aktuelle Ereignis. Mit event.preventDefault() lässt sich der Standardvorgang nur dann verhindern, wenn event.cancelable den Wert true hat. Gehe nicht davon aus, dass sich jede Änderung auf diese Weise stoppen lässt.
Der Attributwert ist JavaScript-Code und kein Ereignisname. Das Beispiel prüft die Behandlung und den Abbruch eines synthetisch ausgelösten beforeinput-Ereignisses; tatsächliches Tippen wird damit nicht simuliert. Der unveränderte Wert ABC beweist daher nicht, dass die native Bearbeitung blockiert wurde.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>onbeforeinput</title>
<input id="editor" value="ABC" onbeforeinput="if (event.cancelable) event.preventDefault()">
<pre id="result"></pre>
<script>
const editor = document.getElementById('editor');
const event = new Event('beforeinput', { bubbles: true, cancelable: true });
const allowed = editor.dispatchEvent(event);
document.getElementById('result').textContent =
`allowed=${allowed}\ndefaultPrevented=${event.defaultPrevented}\nvalue=${editor.value}`;
</script>Ergebnis
allowed=false defaultPrevented=true 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.