KeyboardEvent: свойство charCode

Устарело: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут ее поддерживать, она, возможно, уже удалена из соответствующих веб-стандартов, может быть в процессе удаления или поддерживается только для совместимости. Избегайте ее использования и, при возможности, обновляйте существующий код; обратитесь к таблице совместимости внизу этой страницы, чтобы принять решение. Имейте в виду, что эта функция может перестать работать в любой момент.

Чтение-только свойство charCode интерфейса KeyboardEvent возвращает числовое значение Unicode нажатой клавиши во время события keypress.

Предупреждение: Не используйте это свойство, так как оно устарело. Вместо этого получите числовое значение Unicode символа, используя свойство key.

Значение

Число, представляющее числовое значение Unicode нажатой клавиши.

Примеры

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
  }`;
});

Результат

Примечания

В событии keypress числовое значение Unicode нажатой клавиши хранится либо в свойстве keyCode, либо в свойстве charCode, но никогда не в обоих. Если нажатая клавиша генерирует символ (например, 'a'), charCode устанавливается в код этого символа; charCode учитывает регистр (другими словами, charCode учитывает, удерживается ли клавиша shift). В противном случае код нажатой клавиши хранится в keyCode.
Когда нажаты одна или несколько клавиш-модификаторов, существуют некоторые сложные правила для charCode. Подробности см. в разделе Событие Gecko Keypress.
charCode никогда не устанавливается в событиях keydown и keyup. В этих случаях устанавливается keyCode.
Чтобы получить код клавиши независимо от того, хранился ли он в keyCode или charCode, обратитесь к свойству which.
Символы, введённые с помощью Input method editor, не регистрируются с помощью keyCode или charCode.
Для списка значений charCode , связанных с определенными клавишами, выполните Пример 7: Отображение свойств объекта события и просмотрите результирующую HTML-таблицу.

Спецификации

Спецификация
UI Events # dom-keyboardevent-charcode

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`charCode`	1	12	1.5	12.1	1.2	18	4	12.1	1	1.0	≤37

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/charCode