Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Element: keypress-Ereignis

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Das keypress-Ereignis wird ausgelöst, wenn eine Buchstabe, Zahl, Interpunktionszeichen oder Symbol-Taste gedrückt wird, oder wenn die Enter-Taste gedrückt wird – einschließlich wenn die Enter-Taste in Kombination mit der Shift- oder Ctrl-Taste gedrückt wird. Ansonsten wird das keypress-Ereignis nicht ausgelöst, wenn eine Modifikatortaste wie Alt, Shift, Ctrl, Meta, Esc oder Option isoliert gedrückt wird.

Warnung: Da dieses Ereignis als veraltet gilt, sollten Sie stattdessen beforeinput oder keydown verwenden.

Das Ereignis bubbelt. Es kann Document und Window erreichen.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Event-Handler-Eigenschaft.

js
addEventListener("keypress", (event) => { })

onkeypress = (event) => { }

Ereignistyp

Ein KeyboardEvent. Erbt von UIEvent und Event.

Event UIEvent KeyboardEvent

Beispiele

addEventListener keypress-Beispiel

Dieses Beispiel protokolliert den Wert von KeyboardEvent.code, wenn Sie nach dem Fokussieren des <input>-Elements eine Taste drücken.

Um zu sehen, welche Tasten ein keypress-Ereignis auslösen und welche nicht, versuchen Sie, die folgenden Tasten zu drücken:

  • Buchstabentasten, Zahlentasten und Interpunktionstasten
  • Symboltasten wie $, +, =, % und +
  • Modifikatortasten wie Alt, Shift, Ctrl, Meta, Esc, Option oder
  • die Enter-Taste
  • die Enter-Taste in Kombination mit den Shift- oder Ctrl-Tasten
  • die Enter-Taste in Kombination mit anderen Modifikatortasten als Shift oder Ctrl
html
<div>
  <label for="sample">Focus the input and type something:</label>
  <input type="text" name="text" id="sample" />
</div>
<p id="log"></p>
js
const log = document.getElementById("log");
const input = document.querySelector("input");

input.addEventListener("keypress", logKey);

function logKey(e) {
  log.textContent += ` ${e.code}`;
}

onkeypress-Äquivalent

js
input.onkeypress = logKey;

Spezifikationen

Spezifikation
UI Events
# event-type-keypress
HTML
# handler-onkeypress

Browser-Kompatibilität

Siehe auch