KeyboardEvent: charCode-Eigenschaft
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.
Die schreibgeschützte Eigenschaft charCode
des KeyboardEvent
-Interfaces gibt den Unicode-Wert einer Zeichen-Taste zurück, die während eines keypress
-Ereignisses gedrückt wurde.
Warnung: Verwenden Sie diese Eigenschaft nicht, da sie veraltet ist. Stattdessen können Sie den Unicode-Wert des Zeichens mit der key
-Eigenschaft abrufen.
Wert
Eine Zahl, die den Unicode-Wert der gedrückten Zeichen-Taste darstellt.
Beispiele
HTML
<p>Type anything into the input box below to log a <code>charCode</code>.</p>
<input type="text" />
<p id="log"></p>
JavaScript
const input = document.querySelector("input");
const log = document.querySelector("#log");
input.addEventListener("keypress", (e) => {
log.innerText = `Key pressed: ${String.fromCharCode(e.charCode)}\ncharCode: ${
e.charCode
}`;
});
Ergebnis
Hinweise
-
In einem
keypress
-Ereignis wird der Unicode-Wert der gedrückten Taste entweder in derkeyCode
- oder dercharCode
-Eigenschaft gespeichert, jedoch niemals in beiden. Wenn die gedrückte Taste ein Zeichen erzeugt (z. B. 'a'), wirdcharCode
auf den Code dieses Zeichens gesetzt;charCode
respektiert die Groß- und Kleinschreibung (mit anderen Worten,charCode
berücksichtigt, ob die Shift-Taste gedrückt wird). Andernfalls wird der Code der gedrückten Taste inkeyCode
gespeichert. -
Wenn eine oder mehrere Modifikatortasten gedrückt werden, gibt es einige komplexe Regeln für
charCode
. Details finden Sie unter Gecko Keypress Event. -
charCode
wird niemals in denkeydown
- undkeyup
-Ereignissen gesetzt. In diesen Fällen wird stattdessenkeyCode
gesetzt. -
Um den Code der Taste zu erhalten, unabhängig davon, ob er in
keyCode
odercharCode
gespeichert wurde, verwenden Sie diewhich
-Eigenschaft. -
Zeichen, die über einen Eingabemethoden-Editor eingegeben werden, werden nicht über
keyCode
odercharCode
registriert. -
Für eine Liste der
charCode
-Werte, die bestimmten Tasten zugeordnet sind, führen Sie Beispiel 7: Anzeigen von Ereignisobjekteigenschaften aus und sehen Sie sich die resultierende HTML-Tabelle an.
Spezifikationen
Specification |
---|
UI Events # dom-keyboardevent-charcode |
Browser-Kompatibilität
BCD tables only load in the browser