Element: keypress-Event
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.
Das keypress
-Ereignis wird ausgelöst, wenn eine Taste gedrückt wird, die einen Zeichenwert erzeugt.
Beispiele für Tasten, die einen Zeichenwert erzeugen, sind alphabetische, numerische und Interpunktionstasten. Beispiele für Tasten, die keinen Zeichenwert erzeugen, sind Modifikatortasten wie Alt, Shift, Ctrl oder Meta.
Warnung: Da dieses Ereignis veraltet ist, sollten Sie stattdessen beforeinput
oder keydown
verwenden.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
, oder legen Sie eine Ereignis-Handler-Eigenschaft fest.
addEventListener("keypress", (event) => {});
onkeypress = (event) => {};
Ereignistyp
Ein KeyboardEvent
. Erbt von UIEvent
und Event
.
Ereigniseigenschaften
Diese Schnittstelle erbt auch Eigenschaften ihrer Eltern, UIEvent
und Event
.
KeyboardEvent.altKey
Nur lesbar-
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
Nur lesbar-
Gibt einen String mit dem Code-Wert der physischen Taste zurück, die durch das Ereignis repräsentiert wird.
KeyboardEvent.ctrlKey
Nur lesbar-
Gibt einen Booleschen Wert zurück, der
true
ist, wenn die Ctrl-Taste aktiv war, als das Tastenereignis erzeugt wurde. KeyboardEvent.isComposing
Nur lesbar-
Gibt einen Booleschen Wert zurück, der
true
ist, wenn das Ereignis zwischencompositionstart
undcompositionend
ausgelöst wird. KeyboardEvent.key
Nur lesbar-
Gibt einen String zurück, der den Tastenwert der durch das Ereignis repräsentierten Taste wiedergibt.
KeyboardEvent.location
Nur lesbar-
Gibt eine Zahl zurück, die die Position der Taste auf der Tastatur oder einem anderen Eingabegerät angibt. Eine Liste der Konstanten, die die Positionen identifizieren, ist in Tastaturpositionen dargestellt.
KeyboardEvent.metaKey
Nur lesbar-
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
Nur lesbar-
Gibt einen Booleschen Wert zurück, der
true
ist, wenn die Taste gehalten wird, so dass sie automatisch wiederholt wird. KeyboardEvent.shiftKey
Nur lesbar-
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 drücken nachdem Sie das <input>
-Element fokussiert haben.
<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}`;
}
Äquivalent zu onkeypress
input.onkeypress = logKey;
Spezifikationen
Specification |
---|
UI Events # event-type-keypress |
HTML Standard # handler-onkeypress |
Browser-Kompatibilität
BCD tables only load in the browser