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 schreibgeschützte charCode-Eigenschaft 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 sollten Sie den Unicode-Wert des Zeichens über die key-Eigenschaft abrufen.

Wert

Eine Zahl, die den Unicode-Wert der gedrückten Zeichen-Taste darstellt.

Beispiele

HTML

html
<p>Type anything into the input box below to log a <code>charCode</code>.</p>
<input type="text" />
<p id="log"></p>

JavaScript

js
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

  • Bei einem keypress-Ereignis wird der Unicode-Wert der gedrückten Taste entweder in der keyCode- oder charCode-Eigenschaft gespeichert, aber nie in beiden. Wenn die gedrückte Taste ein Zeichen erzeugt (z.B. 'a'), wird charCode auf den Code dieses Zeichens gesetzt; charCode berücksichtigt dabei die Groß- und Kleinschreibung (das heißt, charCode berücksichtigt, ob die Shift-Taste gedrückt ist). Andernfalls wird der Code der gedrückten Taste in keyCode gespeichert.

  • Wenn eine oder mehrere Modifikatortasten gedrückt werden, gibt es einige komplexe Regeln für charCode. Siehe Gecko Keypress Event für Details.

  • charCode wird niemals bei den keydown- und keyup-Ereignissen gesetzt. In diesen Fällen wird stattdessen keyCode gesetzt.

  • Um den Code der Taste zu erhalten, unabhängig davon, ob er in keyCode oder charCode gespeichert wurde, sollten Sie die which-Eigenschaft abfragen.

  • Durch ein IME eingegebene Zeichen werden weder über keyCode noch über charCode 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