vue3-事件处理

事件监听

• DOM 事件监听指令 v-on 简写@

v-on:click="handler"
或者
@click="handler"

• 事件处理器 (handler) 的值可以是：

1. 内联事件处理器：比如 click

2. 方法事件处理器：一个指向组件上定义的方法的属性名或是路径。

3. 在内联处理器中调用方法（自定义参数）

4. 在内联事件处理器中访问事件参数 （自定义参数和原生 event 事件）

• 方式 1 你可以向该处理器方法传入一个特殊的 $event 变量

• 方式 2 使用内联箭头函数

<script?lang="ts"?setup>
import?{?ref?}?from?"vue"

const?count?=?ref(0)

//?自定义方法
const?name?=?ref('Vue.js')
function?greet(event:?any)?{
????alert(`Hello?${name.value}!`)
????//?`event`?是?DOM?原生事件
????if?(event)?{
????????alert(event.target.tagName)
????}
}

function?say(message:?string)?{
????alert(message)
}

function?warn(message:?string,?event:?any)?{
????//?这里可以访问原生事件
????if?(event)?{
????????event.preventDefault()
????}
????alert(message)
}

function?onClick()?{
????alert(123);
}

</script>

<template>
????<div?class="container">
????????<button?@click="count++">(@click事件)?点击?+1</button>
????????<p>计数器:?{{?count?}}</p>

????????<!--?`greet`?是上面定义过的方法名?-->
????????<button?@click="greet">调用方法?@click="greet"?默认是event参数</button>


????????<br?/>
????????<!--?自定义方法传参?-->
????????<button?@click="say('你好')">自定义方法传参say('你好')替换掉原生event事件参数</button>


????????<br?/>
????????<!--?自定义参数?并?传入原生事件?形式1?-->
????????<!--?使用特殊的?$event?变量?-->
????????<button?@click="warn('表单还未提交?形式1拦截.',?$event)">
????????????Submit提交?-?形式1?$event?变量
????????</button>


????????<br?/>
????????<!--?自定义参数?并?传入原生事件?形式2?-->
????????<!--?使用内联箭头函数?-->
????????<button?@click="(event)?=>?warn('表单还未提交?形式2拦截.',?event)">
????????????Submit提交-?形式2?箭头函数
????????</button>
????????<br?/>
????</div>
</template>

<style?lang="scss"?scoped>
.container?{}
</style>

示例

事件修饰符

在处理事件时调用 event.preventDefault() 或 event.stopPropagation() 是很常见的。

v-on 提供了事件修饰符。修饰符是用 . 表示的指令后缀，包含以下这些：

修饰符	简介
stop	单击事件将停止传递
prevent	提交事件将不再重新加载页面
self	元素本身时才会触发事件处理器
capture	事件冒泡时，优先触发该修饰符事件，多个嵌套则由外而内触发
once	点击事件最多被触发一次
passive	一般用于触摸事件的监听器，可以用来改善移动端设备的滚屏性能

<!--?单击事件将停止传递?-->
<a?@click.stop="doThis"></a>

<!--?提交事件将不再重新加载页面?-->
<form?@submit.prevent="onSubmit"></form>

<!--?修饰语可以使用链式书写?-->
<a?@click.stop.prevent="doThat"></a>

<!--?也可以只有修饰符?-->
<form?@submit.prevent></form>

<!--?仅当?event.target?是元素本身时才会触发事件处理器?-->
<!--?例如：事件处理器不来自子元素?-->
<div?@click.self="doThat">...</div>

<!--?添加事件监听器时，使用?`capture`?捕获模式?-->
<!--?例如：指向内部元素的事件，在被内部元素处理前，先被外部处理?-->
<div?@click.capture="doThis">...</div>

<!--?点击事件最多被触发一次?-->
<a?@click.once="doThis"></a>

<!--?滚动事件的默认行为?(scrolling)?将立即发生而非等待?`onScroll`?完成?-->
<!--?以防其中包含?`event.preventDefault()`?-->
<div?@scroll.passive="onScroll">...</div>

使用修饰符时需要注意调用顺序，因为相关代码是以相同的顺序生成的。

1. @click.prevent.self

会阻止元素及其子元素的所有点击事件的默认行为

1. @click.self.prevent

则只会阻止对元素本身的点击事件的默认行为

按键修饰符

在监听键盘事件时，我们经常需要检查特定的按键。

<!--?仅在?`key`?为?`Enter`?时调用?`submit`?-->
<input?@keyup.enter="submit"?/>

你可以直接使用 KeyboardEvent.key 暴露的按键名称作为修饰符，但需要转为 kebab-case 形式。

<input?@keyup.page-down="onPageDown"?/>

在上面的例子中，仅会在 $event.key 为 'PageDown' 时调用事件处理。

常用按键别名

• enter

• tab

• delete (捕获“Delete”和“Backspace”两个按键)

• esc

• space

• up

• down

• left

• right

系统按键修饰符

你可以使用以下系统按键修饰符来触发鼠标或键盘事件监听器，只有当按键被按下时才会触发

• .ctrl

• .alt

• .shift

• .meta

<!--?Alt?+?Enter?-->
<input?@keyup.alt.enter="clear"?/>

<!--?Ctrl?+?点击?-->
<div?@click.ctrl="doSomething">Do?something</div>

请注意，系统按键修饰符和常规按键不同。与 keyup 事件一起使用时，该按键必须在事件发出时处于按下状态。换句话说，keyup.ctrl 只会在你仍然按住 ctrl 但松开了另一个键时被触发。若你单独松开 ctrl 键将不会触发。

.exact 修饰符

.exact 修饰符允许控制触发一个事件所需的确定组合的系统按键修饰符。

<!--?只要按下?Ctrl?时，不管按不按其他按键都会触发?-->
<button?@click.ctrl="onClick">A</button>

<!--?仅当按下?Ctrl?且未按任何其他键时才会触发?-->
<button?@click.ctrl.exact="onCtrlClick">A</button>

<!--?仅当没有按下任何系统按键时触发?-->
<button?@click.exact="onClick">A</button>

鼠标按键修饰符

• .left

• .right

• .middle 这些修饰符将处理程序限定为由特定鼠标按键触发的事件。