diff --git a/src/.vitepress/sidebars/vue.yaml b/src/.vitepress/sidebars/vue.yaml index 19d7284..184c4ef 100644 --- a/src/.vitepress/sidebars/vue.yaml +++ b/src/.vitepress/sidebars/vue.yaml @@ -133,6 +133,22 @@ link: /frontend/vue/event-handling/arguments#访问自定义参数 - text: 访问原生事件参数 link: /frontend/vue/event-handling/arguments#访问原生事件参数 + - text: 修饰符 + link: /frontend/vue/event-handling/modifiers + items: + - text: 事件修饰符 + link: /frontend/vue/event-handling/modifiers#事件修饰符 + - text: 按键修饰符 + link: /frontend/vue/event-handling/modifiers#按键修饰符 + items: + - text: 常用按键别名 + link: /frontend/vue/event-handling/modifiers#常用按键别名 + - text: 系统按键修饰符 + link: /frontend/vue/event-handling/modifiers#系统按键修饰符 + - text: .exact 修饰符 + link: /frontend/vue/event-handling/modifiers#exact-修饰符 + - text: 鼠标按键修饰符 + link: /frontend/vue/event-handling/modifiers#鼠标按键修饰符 - text: 表单 collapsed: true items: diff --git a/src/frontend/vue/event-handling/modifiers.md b/src/frontend/vue/event-handling/modifiers.md new file mode 100644 index 0000000..3e60744 --- /dev/null +++ b/src/frontend/vue/event-handling/modifiers.md @@ -0,0 +1,106 @@ +# 修饰符 + +## 事件修饰符 + +在处理事件时调用`event.preventDefault()`或`event.stopPropagation()`是非常常见的需求。但如果方法能更专注于数据逻辑而不用处理 DOM 事件细节会更好。 + +Vue 提供的事件修饰符解决了这一问题: + +| 修饰符 | 说明 | +| ---------- | -------------------------------------- | +| `.stop` | 阻止事件冒泡 | +| `.prevent` | 阻止事件默认行为 | +| `.capture` | 使用事件捕获模式 | +| `.self` | 只有当事件在该元素本身触发时才触发回调 | +| `.once` | 事件只触发一次 | +| `.passive` | 指示浏览器不要阻止事件的默认行为 | + +::: tip + +- 事件修饰符可以链式使用,但要注意顺序。例如:`@click.prevent.self` 会阻止元素及其子元素的所有点击事件的默认行为,`@click.self.prevent` 只会阻止元素本身的点击事件的默认行为。 + +- 不能同时使用 `.passive` 和 `.prevent` 修饰符,因为`.passive` 会告诉浏览器不要阻止事件的默认行为,而`.prevent` 会告诉浏览器阻止事件的默认行为。 + +::: + +## 按键修饰符 + +Vue 允许在监听按键事件时添加按键修饰符。 + +```vue + + +``` + +或是直接使用`KeyboardEvent.key`暴露的按键名称作为修饰符,但需要使用 kebab-case 格式。 + +```vue + + +``` + +### 常用按键别名 + +| 修饰符 | 说明 | +| --------- | ------------------------ | +| `.enter` | 回车键 | +| `.tab` | Tab 键 | +| `.delete` | Delete 键和 Backspace 键 | +| `.esc` | ESC 键 | +| `.space` | 空格键 | +| `.up` | 上箭头键 | +| `.down` | 下箭头键 | +| `.left` | 左箭头键 | +| `.right` | 右箭头键 | + +### 系统按键修饰符 + +| 修饰符 | 说明 | +| -------- | -------- | +| `.ctrl` | Ctrl 键 | +| `.alt` | Alt 键 | +| `.shift` | Shift 键 | +| `.meta` | Meta 键 | + +```vue + + + + +