Vue 2 中可通过 Vue.config.keyCodes 添加自定义按键别名(如 f2: 113),用于 @keyup.xxx 语法;Vue 3 已移除该配置,改用 Composition API 封装 useKeyboard Hook 实现键监听。

Vue 中可以通过全局配置 config.keyCodes 添加自定义按键别名,让 @keyup.xxx 或 @keydown.xxx 语法支持你指定的键,比如 F2、Ctrl+P 或自定义功能键。
Vue 2 中设置自定义按键别名
在 Vue 实例创建前(如 main.js),通过 Vue.config.keyCodes 注册键码映射:
- 键名必须是合法的标识符(推荐用 kebab-case 并加引号)
- 值可以是单个数字(如
113对应 F2)、数字数组(兼容多码情况),或字符串(Vue 3 不支持字符串,但 Vue 2 兼容)
示例:为 F2 键添加别名 f2
Vue.config.keyCodes = {
f2: 113,
'media-play-pause': 179,
'ctrl-p': [17, 80] // ⚠️ 注意:组合键不能直接用 keyCodes 实现匹配,这只是注册别名,实际仍需手动判断修饰键
};之后即可在模板中使用:
<input><button>播放/暂停</button>
Vue 3 中不再支持 keyCodes,改用 Composition API + 自定义 Hook
Vue 3 已移除 config.keyCodes,推荐封装 useKeyboard 这类 Hook 来统一处理自定义键监听:
- 接受字符串(如
'F2')、数组(如['Control', 'KeyC'])、或函数(自定义匹配逻辑) - 自动绑定到
window,组件卸载时自动清理事件监听器 - 支持
preventDefault和stopPropagation配置
示例调用:
import { useKeyboard } from '@/composables/useKeyboard';
export default {
setup() {
useKeyboard('F2', () => console.log('F2 pressed'), { event: 'keydown' });
useKeyboard(['Control', 'KeyS'], () => save(), { preventDefault: true });
return {};
}
};监听组合键或特殊物理键的注意事项
单纯靠 .keyCodes 或修饰符无法可靠识别组合键(如 Ctrl+S)。真正健壮的做法是:
- 监听
keydown,检查event.ctrlKey && event.key === 's' - 优先使用
event.code判断物理按键(如'KeyS'),避免受输入法/布局影响 - 对功能键(F1–F12、Media keys)建议查表确认跨浏览器一致的
code或key值
常见自定义键码参考(十进制)
以下键码在多数浏览器中通用,可用于 keyCodes 配置或 event.keyCode 判断(注意:keyCode 已废弃,仅作兼容参考):
- F1–F12:112–123
- PrintScreen:44
- ScrollLock:145
- Pause/Break:19
- Insert:45
- Home/End/PageUp/PageDown:36/35/33/34
- NumLock:144
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











