大网数据广告活动
Web 标准与前端开发

KeyboardEvent:charCode 属性

· 52CE 我爱测

KeyboardEvent 接口的 **`charCode`** 只读属性返回在 Element/keypress_event 事件中按下的字符键的 Unicode 值。

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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。