KeyboardEvent: charCode-Eigenschaft
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.
Die charCode-Eigenschaft der
KeyboardEvent-Schnittstelle gibt den Unicode-Wert eines Zeichenschlüssels zurück,
der während eines keypress-Ereignisses gedrückt wurde.
Warnung:
Verwenden Sie diese Eigenschaft nicht, da sie veraltet ist. Stattdessen sollten Sie den
Unicode-Wert des Zeichens mittels der key-Eigenschaft
abrufen.
Wert
Eine Zahl, die den Unicode-Wert des gedrückten Zeichenschlüssels 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
Anmerkungen
- Bei einem
keypress-Ereignis wird der Unicode-Wert des gedrückten Schlüssels entweder in derkeyCode- oder dercharCode-Eigenschaft gespeichert, jedoch nie in beiden. Wenn der gedrückte Schlüssel ein Zeichen erzeugt (z. B. 'a'), wirdcharCodeauf den Code dieses Zeichens gesetzt;charCodeberücksichtigt die Groß- und Kleinschreibung (mit anderen Worten,charCodeberücksichtigt, ob die Shift-Taste gedrückt gehalten wird). Andernfalls wird der Code des gedrückten Schlüssels inkeyCodegespeichert. charCodewird niemals in denkeydown- undkeyup-Ereignissen gesetzt. In diesen Fällen wird stattdessenkeyCodegesetzt.- Um den Code des Schlüssels zu erhalten, unabhängig davon, ob er in
keyCodeodercharCodegespeichert wurde, fragen Sie diewhich-Eigenschaft ab. - Zeichen, die über einen Input Method Editor eingegeben werden, werden nicht über
keyCodeodercharCoderegistriert. - Für eine Liste der
charCode-Werte, die bestimmten Tasten zugeordnet sind, führen Sie Beispiel 7: Anzeigen von Event-Objekteigenschaften aus und sehen Sie sich die resultierende HTML-Tabelle an.
Spezifikationen
| Specification |
|---|
| UI Events # dom-keyboardevent-charcode |
Browser-Kompatibilität
Loading…