Template reference variables in Angular

Introduction

Template reference variables let you easily access elements or components inside your Angular template. They help you interact with parts of your page without extra code.

You want to get the value of an input box when a button is clicked.

You need to call a method on a child component from the template.

You want to focus an input field programmatically.

You want to read or change properties of an HTML element directly in the template.

Syntax

Angular

<element #variableName></element>

The #variableName creates a reference to the element or component.

You can use this variable elsewhere in the template to access the element or component's properties and methods.

Examples

This example shows how to get the value of an input box when the button is clicked.

Angular

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

Here, the template reference variable accesses a child component to call its method.

Angular

<child-component #childRef></child-component>
<button (click)="childRef.doSomething()">Call Child Method</button>

This example uses the reference to focus the input field when the button is clicked.

Angular

<input #inputRef type="text">
<button (click)="inputRef.focus()">Focus Input</button>

Sample Program

This component uses a template reference variable #nameInput to get the input value when the button is clicked. It then shows a greeting message below.

Angular

import { Component } from '@angular/core';

@Component({
  selector: 'app-root',
  template: `
    <h1>Template Reference Variable Demo</h1>
    <input #nameInput type="text" placeholder="Enter your name">
    <button (click)="greet(nameInput.value)">Greet</button>
    <p>{{ message }}</p>
  `
})
export class AppComponent {
  message = '';

  greet(name: string) {
    this.message = `Hello, ${name}!`;
  }
}

Important Notes

Template reference variables only work inside the template where they are declared.

They do not create variables in the component class, only in the template.

You can reference native HTML elements or Angular components.

Summary

Template reference variables let you access elements or components directly in your template.

They are useful for reading values, calling methods, or manipulating elements without extra code in the component.

Use #variableName syntax to create them and then use the variable in your template expressions.

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