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, Satzzeichen 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-Taste oder der Ctrl-Taste gedrückt wird. Andernfalls, wenn eine Modifizierertaste wie die Alt, Shift, Ctrl, Meta, Esc oder Option-Taste isoliert gedrückt wird, wird das keypress
-Ereignis nicht ausgelöst.
Warnung:
Da dieses Ereignis inzwischen veraltet ist, sollten Sie stattdessen beforeinput
oder keydown
verwenden.
Das Ereignis blubbert. Es kann Document
und Window
erreichen.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("keypress", (event) => { })
onkeypress = (event) => { }
Ereignistyp
Ein KeyboardEvent
. Erbt von UIEvent
und Event
.
Ereigniseigenschaften
Diese Schnittstelle erbt auch Eigenschaften von ihren Eltern, UIEvent
und Event
.
KeyboardEvent.altKey
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der
true
ist, wenn die Alt-Taste (Option oder ⌥ auf macOS) aktiv war, als das Tastenereignis erzeugt wurde. KeyboardEvent.code
Schreibgeschützt-
Gibt einen String mit dem Code-Wert der physischen Taste zurück, die durch das Ereignis repräsentiert wird.
KeyboardEvent.ctrlKey
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der
true
ist, wenn die Ctrl-Taste aktiv war, als das Tastenereignis erzeugt wurde. KeyboardEvent.isComposing
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der
true
ist, wenn das Ereignis zwischencompositionstart
undcompositionend
ausgelöst wird. KeyboardEvent.key
Schreibgeschützt-
Gibt einen String zurück, der den Tastenwert der Taste repräsentiert, die durch das Ereignis dargestellt wird.
KeyboardEvent.location
Schreibgeschützt-
Gibt eine Zahl zurück, die die Position der Taste auf der Tastatur oder einem anderen Eingabegerät darstellt. Eine Liste der Konstanten, die die Positionen identifizieren, finden Sie unter Keyboard locations.
KeyboardEvent.metaKey
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der
true
ist, wenn die Meta-Taste (auf Mac-Tastaturen die ⌘ Command-Taste; auf Windows-Tastaturen die Windows-Taste (⊞)) aktiv war, als das Tastenereignis erzeugt wurde. KeyboardEvent.repeat
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der
true
ist, wenn die Taste gedrückt gehalten wird, sodass sie sich automatisch wiederholt. KeyboardEvent.shiftKey
Schreibgeschützt-
Gibt einen booleschen Wert zurück, der
true
ist, wenn die Shift-Taste aktiv war, als das Tastenereignis erzeugt wurde.
Beispiele
Beispiel für addEventListener keypress
Dieses Beispiel protokolliert den KeyboardEvent.code
-Wert, wann immer Sie eine Taste nach dem Fokussieren des <input>
-Elements drücken.
Um zu sehen, welche Tasten ein keypress
-Ereignis auslösen und welche nicht, versuchen Sie, Folgendes zu drücken:
- Buchstabentasten, Zahlentasten und Satzzeichentasten
- Symboltasten wie $, +, =, % und +-Tasten
- Modifizierertasten wie die Alt, Shift, Ctrl, Meta, Esc, Option oder ⌘-Tasten
- die Enter-Taste
- die Enter-Taste in Kombination mit der Shift- oder Ctrl-Taste
- die Enter-Taste in Kombination mit anderen Modifizierertasten als der Shift- oder Ctrl-Taste
<div>
<label for="sample">Focus the input and type something:</label>
<input type="text" name="text" id="sample" />
</div>
<p id="log"></p>
const log = document.getElementById("log");
const input = document.querySelector("input");
input.addEventListener("keypress", logKey);
function logKey(e) {
log.textContent += ` ${e.code}`;
}
onkeypress-Äquivalent
input.onkeypress = logKey;
Spezifikationen
Specification |
---|
UI Events # event-type-keypress |
HTML # handler-onkeypress |