CKTIS / HTML
onkeypress — Event-Handler-Attribut für das keypress-Ereignis
Das globale HTML-Attribut onkeypress enthält JavaScript-Code zur Behandlung des keypress-Ereignisses. Der Attributname hat das Präfix on, der Ereignisname dagegen nicht.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onkeypress="JavaScript statements"onkeypress ist ein globales Event-Handler-Attribut, das für HTML-Elemente verfügbar ist. Sein Wert ist JavaScript-Code, kein Ereignisname und kein boolescher Wert. keypress ist ein veraltetes Ereignis, auf das du dich in neuem Code nicht verlassen solltest.
Das Attribut onkeypress und die JavaScript-Eigenschaft element.onkeypress stellen denselben Handler-Mechanismus für keypress bereit. In das Attribut schreibst du Code; der Eigenschaft weist du eine Funktion oder null zu. Der Parameter event stellt dem ausgeführten Code das Ereignis bereit.
Eine Content Security Policy kann Handler blockieren, die direkt in Attributen stehen. Verwende in diesen Attributwerten niemals Text aus nicht vertrauenswürdigen Quellen als Code.
Das Beispiel löst keypress programmgesteuert aus, um zu zeigen, dass der Handler ohne manuelle Tastenanschläge ausgeführt wird. Der erwartete Text ist keypress; dieser Test zeigt nicht, wann ein Browser beim tatsächlichen Tippen ein keypress-Ereignis erzeugt.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onkeypress demo</title>
<input id="field" aria-label="Text" onkeypress="document.getElementById('result').textContent = event.type">
<output id="result"></output>
<script>
document.getElementById('field').dispatchEvent(
new KeyboardEvent('keypress', { key: 'a' })
);
</script>
</html>Ergebnis
keypress
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.