UI Events
KeyboardEvent 接口的 charCode 只读属性返回在 Element/keypress_event 事件中按下的字符键的 Unicode 值。
[!WARNING] 该属性已被弃用,请勿再使用该属性。要获取字符的 Unicode 值,请改用 KeyboardEvent.key 属性。
值
一个表示按下的字符键的 Unicode 值的数字。
示例
HTML
<p>在下面的输入框中输入任何内容即可记录 <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 = `按下的键:${String.fromCharCode(e.charCode)}\ncharCode:${
e.charCode
}`;
});
结果
示例
备注
- 在 Element/keypress_event 事件中,按键的 Unicode 值保存在 KeyboardEvent.keyCode 或
charCode属性其中之一,不会二者同时都有。如果按下的是字符键(例如“a”),charCode被设置为字符的代码值;charCode会区分大小写(即charCode会考虑 <kbd>shift</kbd> 键是否被按下)。否则,被按下的键的代码被存储在keyCode中。 charCode永远不会在 Element/keydown_event 或 Element/keyup_event 事件中被设置。在这些情况下,keyCode会被设置。- 要获取按键代码而不考虑是存储在
keyCode还是charCode中,请查询 UIEvent/which 属性。 - 通过Input method editor输入的字符,不会被注册到
keyCode和charCode上。 - 要查看与特定按键关联的
charCode值的列表,请运行显示事件对象的属性并查看生成的 HTML 表格。
规范
浏览器兼容性
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
