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 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

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

  • In einem keypress-Ereignis wird der Unicode-Wert der gedrückten Taste entweder in der keyCode- oder der charCode-Eigenschaft gespeichert, jedoch niemals in beiden. Wenn die gedrückte Taste ein Zeichen erzeugt (z. B. 'a'), wird charCode 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 in keyCode 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 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, verwenden Sie die which-Eigenschaft.

  • Zeichen, die über einen Eingabemethoden-Editor eingegeben werden, werden nicht über keyCode oder 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