Vue Tip: Chaining Event Modifiers

Michael Hoffmann

@mokkapps

Template

Most likely you have already called event.preventDefault() or event.stopPropagation() inside event handlers:

Component.vue

<script setup lang="ts">
function onClick(event: Event) {
  event.preventDefault()

  // ... some other logic
}
</script>

<template>
  <button @click="onClick">Click me</button>
</template>

As you can see, you can easily implement this functionality using methods. but as an alternative, Vue provides event modifiers.

Using these modifiers your method contains only the data logic and the DOM event details are part of the template:

Component.vue

<script setup lang="ts">
function onClick(event: Event) {
  // ... some other logic
}
</script>

<template>
  <button @click.prevent="onClick">Click me</button>
</template>

Vue provides the following event modifiers:

.stop
.prevent
.self
.capture
.once
.passive

You can also chain modifiers:

Component.vue

<script setup lang="ts">
function onClick(event: Event) {
  // ... some other logic
}
</script>

<template>
  <button @click.stop.prevent="onClick">Click me</button>
</template>

The sequence of modifiers is significant as the corresponding code is generated in the exact order they appear.An example: Using @click.prevent.self will prevent click's default action on the element itself and its children, while @click.self.prevent will only prevent click's default action on the element itself.

Do not use .passive and .prevent together.By using the .passive modifier, you are effectively signaling to the browser that you have no intention of preventing the default behavior of the event.

If you liked this Vue tip, follow me on BlueSky to get notified about new tips, blog posts, and more. Alternatively (or additionally), you can subscribe to my weekly Vue & Nuxt newsletter :

Nuxt Tip: Move Homepage to Sub-Folder in Nuxt 3

Vue Tip: Effortless Handle Asynchronous Components With Suspense