好的,我们来详细讲解 Vue 中的按键修饰符 (Key Modifiers)。
什么是按键修饰符?
在处理键盘事件(如 keyup
, keydown
)时,我们经常需要判断用户按下的是否是某个特定的按键(比如回车键、Esc键等)。
如果没有按键修饰符,我们的代码可能会是这样:
function onKeyup(event) {
// 需要在方法里写 if 判断
if (event.key === 'Enter') {
submitForm();
}
}
为了简化这种逻辑,Vue 提供了按键修饰符。它们是 v-on
指令的后缀,专门用于在监听键盘事件时,指定只有在按下特定按键时才触发回调函数。
这让我们的模板代码更具语义化,也更简洁。
常用的按键别名 (Key Aliases)
Vue为最常用的一些按键提供了别名,你可以直接在 @keyup
或 @keydown
后面以 .别名
的形式使用。
.enter
- 回车键.tab
- Tab 键 (注意:使用@keydown.tab
通常更有用,因为@keyup.tab
可能会在切换焦点后才触发).delete
- 同时捕获 “Delete” (删除) 和 “Backspace” (退格) 键.esc
- Escape (退出) 键.space
- 空格键.up
- 上箭头.down
- 下箭头.left
- 左箭头.right
- 右箭头
示例:一个简单的待办事项列表
这个例子演示了两个最常见的场景:
- 在输入框中按下回车键 (
.enter
) 添加新事项。 - 在输入框中按下退出键 (
.esc
) 清空输入内容。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>按键修饰符示例</title>
<script src="https://unpkg.com/vue@3/dist/vue.global.js"></script>
<style>
body { font-family: sans-serif; padding: 20px; }
input { width: 300px; padding: 8px; font-size: 1rem; }
ul { list-style: none; padding-left: 0; }
li { background: #f4f4f4; margin-bottom: 5px; padding: 10px; }
</style>
</head>
<body>
<div id="app">
<h3>简单的待办事项</h3>
<p>输入内容后,按“回车”添加,按“Esc”清空。</p>
<input
type="text"
v-model="newItem"
placeholder="想做点什么?"
@keyup.enter="addItem"
@keyup.esc="clearInput"
>
<ul>
<li v-for="(item, index) in items" :key="index">
{{ item }}
</li>
</ul>
</div>
<script>
const { createApp, ref } = Vue;
createApp({
setup() {
const newItem = ref('');
const items = ref(['学习 Vue', '编写代码']);
// 按下回车时调用的方法
function addItem() {
if (newItem.value.trim() === '') return;
items.value.push(newItem.value.trim());
newItem.value = ''; // 清空输入框
}
// 按下 Esc 时调用的方法
function clearInput() {
newItem.value = '';
}
return { newItem, items, addItem, clearInput };
}
}).mount('#app');
</script>
</body>
</html>
系统修饰键 (System Modifier Keys)
Vue 还允许你使用系统修饰键来触发事件,它们可以和普通按键或其他鼠标事件组合使用。
.ctrl
.alt
.shift
.meta
(在 Windows 上是 Windows 徽标键,在 macOS 上是 Command 键 ⌘)
组合示例:
@keyup.enter.shift
: 当用户同时按下Shift
和Enter
时触发。@click.ctrl
: 当用户按住Ctrl
键并同时进行鼠标点击时触发。
<button @click.ctrl="doSomething">Ctrl + Click Me</button>
.exact
精确修饰符
.exact
修饰符允许你控制触发事件所需的确切的系统修饰符组合。
示例对比:
<button @click.ctrl="onClick">A</button>
<button @click.ctrl.exact="onExactClick">B (Exact)</button>
这在你需要定义非常精确的快捷键组合时非常有用。
总结
按键修饰符是 Vue 提供的一个强大工具,它能让你的事件处理代码变得极其声明化和可读。通过将判断逻辑从 JavaScript 方法中移到模板里,你的代码职责划分会更加清晰:模板负责“何时触发”,方法负责“做什么”。