Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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-Schreibgeschützte Eigenschaft des KeyboardEvent-Interfaces gibt den Unicode-Wert einer Zeichentaste 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 Zeichentaste 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 der 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 beachtet die Groß- und Kleinschreibung (das heißt, charCode berücksichtigt, ob die Shift-Taste gedrückt gehalten wird). Andernfalls wird der Code der gedrückten Taste in keyCode gespeichert.
  • 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, fragen Sie die which-Eigenschaft ab.
  • 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, starten Sie Anzeigen der Eigenschaften von Ereignisobjekten und betrachten Sie die resultierende HTML-Tabelle.

Spezifikationen

Specification
UI Events
# dom-keyboardevent-charcode

Browser-Kompatibilität