v-on directive for events in Vue

Introduction

The v-on directive lets you listen to user actions like clicks or key presses and run code when they happen.

When you want to run a function after a button is clicked.

When you need to respond to keyboard input in a form.

When you want to handle mouse movements or hover effects.

When you want to submit a form only after validating input.

When you want to toggle visibility of an element on user interaction.

Syntax

Vue

<element v-on:event="handlerFunction"></element>

You can shorten v-on: to just @ for cleaner code.

The event is the name of the user action like click or keyup.

Examples

Runs sayHello when the button is clicked.

Vue

<button v-on:click="sayHello">Click me</button>

Runs submitForm when the Enter key is pressed inside the input.

Vue

<input v-on:keyup.enter="submitForm">

Shortened syntax using @ to run showTooltip on mouse hover.

Vue

<div @mouseover="showTooltip">Hover me</div>

Sample Program

This Vue component shows a button that counts how many times it is clicked. Each click runs the incrementCount function, increasing the count.

Vue

<template>
  <button @click="incrementCount">Clicked {{ count }} times</button>
</template>

<script setup>
import { ref } from 'vue'
const count = ref(0)
function incrementCount() {
  count.value++
}
</script>

Important Notes

Always use functions or methods for event handlers to keep code organized.

You can listen to many event types like click, input, submit, and keyboard events.

Use modifiers like .prevent or .stop to control event behavior.

Summary

v-on listens to user actions and runs code when they happen.

You can use @ as a shortcut for v-on.

Event handlers help make your app interactive and responsive to users.

Practice

1. What does the v-on directive do in Vue?

easy

A. It fetches data from a server automatically.

B. It listens for user events and runs code when they happen.

C. It styles HTML elements dynamically.

D. It creates new Vue components.

Solution

1. Step 1: Understand the purpose of v-on

   v-on is used to listen to user actions like clicks or key presses.

2. Step 2: Identify what happens when an event is detected

   When the event occurs, v-on runs the specified code or method.

3. Final Answer:

   It listens for user events and runs code when they happen. -> Option B

4. Quick Check:

   Event listening = C [OK]

Hint: Remember: v-on = listen and react to events [OK]

Common Mistakes:

• Confusing v-on with styling directives
• Thinking v-on fetches data automatically
• Assuming v-on creates components

2. Which of the following is the correct syntax to listen for a click event on a button using v-on?

easy

A. Click me

B. Click me

C. Click me

D. Click me

Solution

1. Step 1: Check the correct v-on syntax

   The correct syntax uses a colon after v-on followed by the event name, like v-on:click.

2. Step 2: Verify the event handler format

   The handler should be a method name without parentheses in the directive, so handleClick is correct.

3. Final Answer:

   <button v-on:click="handleClick">Click me</button> -> Option A

4. Quick Check:

   Correct syntax = B [OK]

Hint: Use v-on:event="handler" with colon, no parentheses [OK]

Common Mistakes:

• Using v-on-click instead of v-on:click
• Adding parentheses in the handler inside directive
• Using @click with parentheses (valid but different from v-on syntax)

3. What will happen when the button is clicked in this Vue template?

<button v-on:click="count++">Clicked {{ count }} times</button>
<script setup>
import { ref } from 'vue'
const count = ref(0)
</script>

medium

A. The count will reset to 0 every time the button is clicked.

B. The count will stay at 0 and never change.

C. The button will cause an error because count is not a number.

D. The count will increase by 1 each time the button is clicked and update the displayed number.

Solution

1. Step 1: Understand the reactive variable count

   count is a reactive reference starting at 0, so changes update the UI automatically.

2. Step 2: Analyze the click event handler

   Each click runs count++, increasing the value by 1 and updating the displayed text.

3. Final Answer:

   The count will increase by 1 each time the button is clicked and update the displayed number. -> Option D

4. Quick Check:

   Reactive ref increments = D [OK]

Hint: Reactive refs update UI when changed inside v-on [OK]

Common Mistakes:

• Thinking count is a plain variable, not reactive
• Assuming count resets on each click
• Believing the code causes an error

4. Identify the error in this Vue template:

<button v-on:click="submitForm()">Submit</button>
<script setup>
function submitForm {
  alert('Form submitted')
}
</script>

medium

A. The function declaration is missing parentheses after the name.

B. The event handler should not have parentheses in the template.

C. The alert function is not allowed inside Vue methods.

D. The v-on directive should be written as @click instead.

Solution

1. Step 1: Check the function declaration syntax

   The function submitForm is declared without parentheses, which is invalid syntax in JavaScript.

2. Step 2: Confirm the correct function syntax

   It should be function submitForm() { ... } with parentheses after the name.

3. Final Answer:

   The function declaration is missing parentheses after the name. -> Option A

4. Quick Check:

   Function syntax error = A [OK]

Hint: Always add () after function names in declarations [OK]

Common Mistakes:

• Removing parentheses in function declarations
• Thinking parentheses are wrong in event handlers
• Confusing directive syntax with error cause

5. You want to listen for a key press event on an input using v-on and run a method only when the Enter key is pressed. Which is the correct way to do this in Vue?

hard

A.

B.

C.

D.

Solution

1. Step 1: Understand Vue event modifiers

   Vue supports event modifiers like .enter to listen only for Enter key presses.

2. Step 2: Check the correct syntax for key modifiers

   v-on:keyup.enter="submit()" listens for keyup events only when Enter is pressed and runs submit().

3. Final Answer:

   <input v-on:keyup.enter="submit()" /> -> Option C

4. Quick Check:

   Use .enter modifier for Enter key events = A [OK]

Hint: Use .enter modifier with v-on for Enter key events [OK]

Common Mistakes:

• Trying to check event.key manually inside template
• Using key attribute instead of event modifier
• Forgetting parentheses in method call