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;
规范
浏览器兼容性
参见
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
