KeyboardEvent: charCode Eigenschaft

Wert

Eine Zahl, die den Unicode-Wert der gedrückten Zeichen-Taste 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 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 beachtet dabei 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 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, können Sie die which-Eigenschaft abfragen.
• Zeichen, die über einen Input-Method-Editor eingegeben werden, werden weder über keyCode noch über charCode registriert.
• Für eine Liste der spezifischen charCode-Werte, die mit bestimmten Tasten verknüpft sind, führen Sie Anzeigen von Ereignisobjekteigenschaften aus und sehen Sie sich die resultierende HTML-Tabelle an.

Spezifikationen

Browser-Kompatibilität