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

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

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

Spezifikation
UI Events
# dom-keyboardevent-charcode

Browser-Kompatibilität