v-on directive for events in Vue - Step-by-Step Execution

Concept Flow - v-on directive for events

User action triggers event

↓

v-on directive listens

↓

Event handler function runs

↓

Component state or output updates

↓

DOM re-renders if needed

↓

User sees updated UI

The v-on directive listens for user events, runs a handler function, updates state, and refreshes the UI.

Execution Sample

Vue

<template>
  <button v-on:click="increment">Click me</button>
  <p>Count: {{ count }}</p>
</template>

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

A button uses v-on:click to run increment, increasing count and updating the displayed number.

Execution Table

Step	Event Triggered	State Before	Handler Action	State After	UI Update
1	No event yet	count = 0	No action	count = 0	Shows 'Count: 0'
2	User clicks button	count = 0	increment() runs, count++	count = 1	Shows 'Count: 1'
3	User clicks button again	count = 1	increment() runs, count++	count = 2	Shows 'Count: 2'
4	No further clicks	count = 2	No action	count = 2	Shows 'Count: 2'

💡 No more events, so no handler runs and UI stays at count 2

Variable Tracker

Variable	Start	After 1	After 2	Final
count.value	0	1	2	2

Key Moments - 3 Insights

Why doesn't the count change until I click the button?

Because the v-on directive only runs the handler when the event (click) happens, as shown in steps 2 and 3 of the execution_table.

What happens if I write @click instead of v-on:click?

They are the same; @click is shorthand for v-on:click, so the behavior and execution flow remain identical.

Why does the UI update after the handler runs?

Vue tracks reactive variables like count.value; when increment changes it, Vue re-renders the template to show the new count, as seen in the UI Update column.

Visual Quiz - 3 Questions

Look at the execution_table, what is count.value after the first click event?

A 1

B 0

C 2

D undefined

💡 Hint

Check the 'State After' column at Step 2 in the execution_table.

At which step does the UI show 'Count: 2'?

A Step 1

B Step 3

C Step 2

D Step 4

💡 Hint

Look at the 'UI Update' column in the execution_table for when count reaches 2.

If the user never clicks the button, what will the UI show?

A 'Count: 2'

B 'Count: 1'

C 'Count: 0'

D Nothing

💡 Hint

Refer to Step 1 in the execution_table where no event has occurred yet.

Concept Snapshot

v-on directive listens for events like clicks
Syntax: v-on:event="handler" or shorthand @event="handler"
When event fires, handler runs and can update reactive state
Vue re-renders UI automatically on state change
Use for buttons, inputs, and other user actions

Full Transcript

The v-on directive in Vue listens for user events such as clicks. When the user clicks the button, the event triggers the handler function increment, which increases the reactive count variable. Vue detects this change and updates the displayed count in the UI. The flow starts with the user action, then the directive listens, runs the handler, updates state, and finally re-renders the UI. Without clicks, the count stays at zero and the UI shows 'Count: 0'. The shorthand @click is equivalent to v-on:click. This reactive event handling lets Vue apps respond instantly to user input.

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