CKTIS / HTML
onkeydown — auf einen Tastendruck reagieren
Das Attribut onkeydown enthält JavaScript-Code zur Behandlung des keydown-Ereignisses. Damit lässt sich auf einen Tastendruck reagieren; das event-Objekt stellt Ereignisdaten bereit. Es ist kein boolesches Attribut.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onkeydown="JavaScript statements"onkeydown ist ein HTML-Ereignisbehandlungsattribut für keydown. Sein Wert ist der Funktionskörper von JavaScript, nicht ein Ereignisname oder eine URL. Einen Funktionsnamen lediglich einzutragen, ohne die Funktion aufzurufen, führt sie nicht aus.
Im Attributcode stellt der Parameter event das Ereignis bereit. Das HTML-Attribut onkeydown="…" und die JavaScript-Eigenschaft element.onkeydown richten denselben Mechanismus zur Ereignisbehandlung ein. Wird der Eigenschaft eine neue Funktion zugewiesen, ersetzt sie die bisherige Behandlung.
return false bricht die Standardaktion des Ereignisses ab, sofern das Ereignis abgebrochen werden kann, stoppt aber nicht dessen Weitergabe. Eine Content Security Policy kann direkt in Attribute eingetragene Ereignisbehandlungen blockieren. Füge niemals nicht vertrauenswürdigen Text als Code in das Attribut ein.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onkeydown example</title>
<button type="button" onkeydown="if (event.key === 'Enter') document.getElementById('result').textContent = 'Enter';">Focus here; press Enter</button>
<p id="result" aria-live="polite">Waiting</p>
</html>Ergebnis
Enter
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.