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

Element:keypress 事件

· 52CE 我爱测

`keypress`** 事件在按下字母、数字、标点或符号键时触发,或者在按下 <kbd>Enter</kbd> 键时触发——包括与 <kbd>Shift</kbd> 键或 <kbd>Ctrl</kbd> 键组合按下 <kbd>Enter</kbd> 的情况。否则,单独按下 <kbd>Alt</kbd>、<kbd>Shift</kbd>、<kbd>Ctrl</kbd>、<kbd>Meta</kbd>、<kbd>Esc</kbd> 或 <kbd>Option</kbd> 等修饰键时,*不会*触发 `keypress` 事件。

UI Events

keypress 事件在按下字母、数字、标点或符号键时触发,或者在按下 <kbd>Enter</kbd> 键时触发——包括与 <kbd>Shift</kbd> 键或 <kbd>Ctrl</kbd> 键组合按下 <kbd>Enter</kbd> 的情况。否则,单独按下 <kbd>Alt</kbd>、<kbd>Shift</kbd>、<kbd>Ctrl</kbd>、<kbd>Meta</kbd>、<kbd>Esc</kbd> 或 <kbd>Option</kbd> 等修饰键时,不会触发 keypress 事件。

[!WARNING] 由于此事件已被弃用,你应该改用 beforeinput 或 keydown。

此事件会冒泡。它可以到达 Document 和 Window。

语法

在 EventTarget.addEventListener 等方法中使用事件名称,或设置事件处理器属性。

addEventListener("keypress", (event) => { })

onkeypress = (event) => { }

事件类型

KeyboardEvent。继承自 UIEvent 和 Event。

KeyboardEvent

示例

addEventListener keypress 示例

每当你在聚焦 input 元素后按下某个键时,此示例会记录 KeyboardEvent.code 的值。

要查看哪些键会触发 keypress 事件、哪些键不会,可以试着按下以下按键:

  • 字母键、数字键和标点键
  • 符号键,例如 <kbd>$</kbd>、<kbd>+</kbd>、<kbd>=</kbd>、<kbd>%</kbd> 和 <kbd>+</kbd> 键
  • 修饰键,例如 <kbd>Alt</kbd>、<kbd>Shift</kbd>、<kbd>Ctrl</kbd>、<kbd>Meta</kbd>、<kbd>Esc</kbd>、<kbd>Option</kbd> 或 <kbd>⌘</kbd> 键
  • <kbd>Enter</kbd> 键
  • 与 <kbd>Shift</kbd> 或 <kbd>Ctrl</kbd> 键组合的 <kbd>Enter</kbd> 键
  • 与 <kbd>Shift</kbd> 或 <kbd>Ctrl</kbd> 以外的修饰键组合的 <kbd>Enter</kbd> 键
<div>
  <label for="sample">聚焦输入框并输入一些内容:</label>
  <input type="text" name="text" id="sample" />
</div>
<p id="log"></p>
const log = document.getElementById("log");
const input = document.querySelector("input");

input.addEventListener("keypress", logKey);

function logKey(e) {
  log.textContent += ` ${e.code}`;
}

addEventListener_keypress_示例

等效的 onkeypress

input.onkeypress = logKey;

规范

浏览器兼容性

参见

  • Document 接口,此事件也会以它为目标。
  • 相关事件:

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

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

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

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