Template reference variables in Angular - Performance & Optimization

Performance: Template reference variables

MEDIUM IMPACT

Template reference variables affect DOM access and event handling performance by providing direct references to elements or components without extra queries.

Accessing an input element's value on a button click

Angular

<input #myInput type="text">
<button (click)="handleClick(myInput.value)">Click</button>

handleClick(value: string) {
  console.log(value);
}

Template reference variables provide direct access to the element without querying the DOM repeatedly.

📈 Performance GainNo extra reflows triggered on click, improving interaction speed

Accessing an input element's value on a button click

Angular

handleClick() {
  const input = document.querySelector('#myInput');
  console.log(input.value);
}

Direct DOM queries like document.querySelector run on every event, causing extra layout calculations and slower response.

📉 Performance CostTriggers 1 reflow per click event due to DOM query

Performance Comparison

Pattern	DOM Operations	Reflows	Paint Cost	Verdict
Using document.querySelector in event handlers	1 DOM query per event	1 reflow per event	Low	[X] Bad
Using Angular template reference variables	No extra DOM queries	0 reflows per event	Low	[OK] Good

Rendering Pipeline

Template reference variables are resolved during Angular's template compilation and runtime binding, allowing direct element or component access without extra DOM queries.

→Template Compilation

→Event Handling

→Layout

⚠️ BottleneckEvent Handling stage can be slowed by repeated DOM queries if template references are not used

Core Web Vital Affected

INP

Template reference variables affect DOM access and event handling performance by providing direct references to elements or components without extra queries.

Optimization Tips

1Use template reference variables to access elements directly without DOM queries.

2Avoid document.querySelector or similar DOM queries inside event handlers.

3Reducing layout reflows during events improves interaction responsiveness (INP).

Performance Quiz - 3 Questions

What is the main performance benefit of using Angular template reference variables over document.querySelector?

A They reduce the initial page load time

B They avoid repeated DOM queries during event handling

C They improve CSS selector matching speed

D They decrease JavaScript bundle size

DevTools: Performance

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

What to look for: High scripting time and layout events indicate costly DOM queries; minimal layout events indicate efficient template reference usage.

Practice

1. What is the purpose of a template reference variable in Angular templates?

easy

A. To create a service for dependency injection

B. To define a new Angular component

C. To access a DOM element or component instance directly in the template

D. To write CSS styles inside the template

Solution

1. Step 1: Understand what template reference variables do

   They let you refer to elements or components inside the template without extra code in the component class.

2. Step 2: Identify the correct purpose

   Accessing DOM elements or component instances directly in the template is exactly what template reference variables do.

3. Final Answer:

   To access a DOM element or component instance directly in the template -> Option C

4. Quick Check:

   Template reference variable = direct template access [OK]

Hint: Remember: #variableName points to element/component [OK]

Common Mistakes:

• Confusing template reference variables with component or service creation
• Thinking they are used for styling or CSS
• Assuming they are for dependency injection

2. Which of the following is the correct syntax to declare a template reference variable named inputBox on an <input> element?

easy

A.

B.

C.

D.

Solution

1. Step 1: Recall Angular template reference variable syntax

   Angular uses the #variableName syntax to declare template reference variables.

2. Step 2: Match the syntax to the options

   Only uses #inputBox which is correct.

3. Final Answer:

   <input #inputBox> -> Option A

4. Quick Check:

   #variableName syntax = correct declaration [OK]

Hint: Use # before name to declare template reference variable [OK]

Common Mistakes:

• Using ref, var, or let which are not Angular template reference syntax
• Confusing Angular syntax with other frameworks
• Missing the # symbol

3. Given the template snippet:

<input #myInput type="text">
<button (click)="alert(myInput.value)">Show Value</button>

What happens when the button is clicked after typing "Hello" in the input?

medium

A. An alert box shows the text "Hello"

B. An alert box shows the text "myInput"

C. Nothing happens because myInput is undefined

D. A runtime error occurs

Solution

1. Step 1: Understand the template reference variable usage

   The #myInput variable refers to the input element. Accessing myInput.value gets the current text typed.

2. Step 2: Analyze the button click event

   Clicking the button calls alert(myInput.value), so it shows the input's current value.

3. Final Answer:

   An alert box shows the text "Hello" -> Option A

4. Quick Check:

   myInput.value alerts typed text [OK]

Hint: Template ref variable .value gets input content [OK]

Common Mistakes:

• Thinking myInput is a string instead of element reference
• Assuming myInput is undefined or inaccessible
• Expecting no action or error on click

4. Consider this template code:

<input #userInput type="text">
<button (click)="logValue()">Log</button>

And component code:

logValue() {
  console.log(userInput.value);
}

What is the problem here?

medium

A. The template reference variable should be declared with $ sign

B. userInput is not defined in the component class, causing an error

C. logValue() should be an arrow function

D. There is no problem; it works fine

Solution

1. Step 1: Identify scope of template reference variables

   Template reference variables exist only in the template, not in the component class.

2. Step 2: Check component method usage

   The method tries to access userInput directly, which is undefined in the class, causing an error.

3. Final Answer:

   userInput is not defined in the component class, causing an error -> Option B

4. Quick Check:

   Template refs not accessible in class directly [OK]

Hint: Template refs only work inside template, not class methods [OK]

Common Mistakes:

• Trying to use template refs inside component class directly
• Thinking template refs need $ or other symbols
• Assuming arrow functions fix scope issues

5. How can you use a template reference variable to reset an input field's value to empty when clicking a button?

<input #myInput type="text">
<button (click)="???">Reset</button>

Which is the correct replacement for ????

hard

A. this.myInput.value = ''

B. myInput.reset()

C. reset(myInput)

D. myInput.value = ''

Solution

1. Step 1: Understand template reference variable usage in event binding

   You can directly access the element via the variable and set its properties in the template expression.

2. Step 2: Choose the correct syntax to clear input value

   Setting myInput.value = '' clears the input. Using this or calling reset() method is incorrect here.

3. Final Answer:

   myInput.value = '' -> Option D

4. Quick Check:

   Directly assign empty string to .value to reset [OK]

Hint: Assign empty string to .value on template ref to clear input [OK]

Common Mistakes:

• Using this.myInput which is undefined in template
• Calling reset() which input element does not have
• Trying to call a function reset() without defining it