Directive with arguments and modifiers in Vue - Performance & Optimization

Performance: Directive with arguments and modifiers

MEDIUM IMPACT

This affects how Vue processes directives during rendering, impacting the number of DOM updates and reflows triggered by directive logic.

Applying a custom directive with multiple modifiers and dynamic arguments to update DOM elements

Vue

app.directive('focus', {
  mounted(el, binding) {
    const { arg, modifiers } = binding;
    if (arg === 'input' && modifiers.lazy) {
      const handler = () => el.focus();
      el.addEventListener('change', handler, { once: true });
    } else if (arg === 'button' && modifiers.immediate) {
      el.focus();
    }
  }
});

This version uses event listener options to avoid multiple bindings and limits focus calls, reducing unnecessary DOM updates.

📈 Performance Gainreduces event listeners and reflows, improving INP and responsiveness

Applying a custom directive with multiple modifiers and dynamic arguments to update DOM elements

Vue

app.directive('focus', {
  mounted(el, binding) {
    if (binding.arg === 'input' && binding.modifiers.lazy) {
      el.addEventListener('change', () => {
        el.focus();
      });
    } else if (binding.arg === 'button' && binding.modifiers.immediate) {
      el.focus();
    }
  }
});

This directive checks multiple conditions and attaches event listeners inside the directive, causing extra event bindings and potential multiple reflows on updates.

📉 Performance Costtriggers multiple event listeners and reflows per element, increasing INP latency

Performance Comparison

Pattern	DOM Operations	Reflows	Paint Cost	Verdict
Directive with multiple modifiers and dynamic arguments causing repeated event listeners	Multiple event listeners per element	Multiple reflows per event	High paint cost due to frequent focus calls	[X] Bad
Directive with optimized event listener usage and conditional logic	Single event listener per element	Single reflow per event	Lower paint cost with limited focus calls	[OK] Good

Rendering Pipeline

Vue processes directives during the patch phase, applying argument and modifier logic to update the DOM. Complex logic can cause multiple layout recalculations and event bindings.

→JavaScript Execution

→Layout

→Paint

⚠️ BottleneckLayout stage due to multiple DOM updates triggered by directive logic

Core Web Vital Affected

INP

This affects how Vue processes directives during rendering, impacting the number of DOM updates and reflows triggered by directive logic.

Optimization Tips

1Avoid attaching multiple event listeners inside directives with modifiers.

2Use event listener options like { once: true } to limit bindings.

3Batch DOM updates inside directives to reduce layout thrashing.

Performance Quiz - 3 Questions

What is a common performance issue when using directives with multiple modifiers and arguments in Vue?

A Attaching multiple event listeners causing repeated reflows

B Reducing bundle size significantly

C Improving LCP by lazy loading directives

D Preventing CLS by fixing layout shifts

DevTools: Performance

How to check: Record a performance profile while interacting with elements using the directive. Look for scripting time and layout events triggered by directive handlers.

What to look for: High scripting time and frequent layout recalculations indicate inefficient directive logic causing poor INP.

Practice

1. In Vue, what does a directive argument specify?
v-bind:title uses title as an argument. What does it do?

easy

A. It adds a CSS class to the element.

B. It changes the directive into a different directive.

C. It tells the directive which attribute or property to target.

D. It defines a new event listener.

Solution

1. Step 1: Understand directive arguments

   Directive arguments specify what part of the element the directive should affect, like an attribute or property.

2. Step 2: Analyze v-bind:title

   Here, title is the argument telling v-bind to bind the value to the element's title attribute.

3. Final Answer:

   It tells the directive which attribute or property to target. -> Option C

4. Quick Check:

   Directive argument = target attribute/property [OK]

Hint: Arguments specify target attribute/property in directives [OK]

Common Mistakes:

• Thinking arguments change directive type
• Confusing arguments with modifiers
• Assuming arguments add CSS classes

2. Which of the following is the correct syntax to use a modifier with a directive argument in Vue?
v-on:click.prevent is an example. Which is correct?

easy

A. v-on:click.prevent

B. v-on.prevent:click

C. v-on:prevent.click

D. v-on:click.prevent()

Solution

1. Step 1: Recall Vue directive syntax

   In Vue, modifiers come after the argument, separated by dots, e.g., v-on:click.prevent.

2. Step 2: Check each option

   v-on:click.prevent matches the correct pattern: directive, colon, argument, dot, modifier. Others mix order or add parentheses incorrectly.

3. Final Answer:

   v-on:click.prevent -> Option A

4. Quick Check:

   Modifiers follow arguments with dots [OK]

Hint: Modifiers come after arguments, separated by dots [OK]

Common Mistakes:

• Placing modifiers before arguments
• Using parentheses with modifiers
• Switching order of argument and modifier

3. What will be the effect of this Vue directive?

<button v-on:click.once.prevent="submit">Submit</button>

medium

A. The submit method runs every click and does not prevent default event.

B. The submit method runs every click and prevents default event.

C. The submit method runs once but does not prevent default event.

D. The submit method runs once on click and prevents default event.

Solution

1. Step 1: Understand modifiers .once and .prevent

   .once makes the event handler run only once. .prevent calls event.preventDefault() to stop default browser behavior.

2. Step 2: Analyze the directive behavior

   The button's click triggers submit only once and prevents default action each time.

3. Final Answer:

   The submit method runs once on click and prevents default event. -> Option D

4. Quick Check:

   .once + .prevent = run once + prevent default [OK]

Hint: Modifiers chain to combine behaviors like once and prevent [OK]

Common Mistakes:

• Ignoring the effect of .once modifier
• Confusing .prevent with .stop
• Assuming method runs multiple times

4. Identify the error in this Vue directive usage:

<input v-model.trim.lazy="username">

medium

A. The directive should be v-model:trim.lazy with an argument.

B. The syntax is correct; no error present.

C. Modifiers .trim and .lazy cannot be used together on v-model.

D. Modifiers must be separated by commas, like .trim,.lazy.

Solution

1. Step 1: Check Vue documentation for v-model modifiers

   Vue allows chaining modifiers like .trim and .lazy on v-model to trim input and update on change.

2. Step 2: Validate syntax correctness

   The syntax v-model.trim.lazy is valid and commonly used. No argument is needed here.

3. Final Answer:

   The syntax is correct; no error present. -> Option B

4. Quick Check:

   Multiple modifiers can chain on v-model [OK]

Hint: Modifiers chain with dots, no commas needed [OK]

Common Mistakes:

• Thinking modifiers need commas
• Assuming arguments are required for modifiers
• Believing some modifiers can't combine

5. You want to create a custom directive v-focus that focuses an input only once when inserted, and you want to pass an argument to specify the delay in milliseconds. Which is the correct way to use arguments and modifiers to achieve this?

<input v-focus:delay.once="500">

hard

A. Use argument delay for delay and modifier .once to focus once.

B. Use modifier .delay for delay and argument once to focus once.

C. Arguments and modifiers cannot be combined in custom directives.

D. Use v-focus.once:delay="500" to apply once and delay.

Solution

1. Step 1: Understand argument and modifier roles

   Arguments specify extra data like 'delay' to the directive. Modifiers like .once change behavior, here to run focus only once.

2. Step 2: Analyze the directive usage

   v-focus:delay.once="500" correctly uses 'delay' as argument and '.once' as modifier. The value '500' is passed as delay time.

3. Final Answer:

   Use argument delay for delay and modifier .once to focus once. -> Option A

4. Quick Check:

   Argument = data, modifier = behavior change [OK]

Hint: Arguments pass data, modifiers change behavior [OK]

Common Mistakes:

• Swapping argument and modifier positions
• Thinking they can't be combined
• Using modifiers as arguments