Standalone pipes and directives in Angular

Introduction

Standalone pipes and directives let you use them without adding to a module. This makes your code simpler and easier to manage.

You want to create a small reusable pipe or directive without making a module.

You want to share a pipe or directive directly in a component.

You want faster development by avoiding module setup for simple features.

You want to keep your app structure clean and modular.

You want to use Angular's new standalone component system fully.

Syntax

Angular

import { Pipe, PipeTransform } from '@angular/core';

@Pipe({
  name: 'examplePipe',
  standalone: true
})
export class ExamplePipe implements PipeTransform {
  transform(value: string): string {
    return value.toUpperCase();
  }
}

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

@Directive({
  selector: '[exampleDirective]',
  standalone: true
})
export class ExampleDirective {
  // directive logic here
}

Use standalone: true in the decorator to make a pipe or directive standalone.

Standalone pipes and directives can be imported directly into components.

Examples

This standalone pipe reverses a string.

Angular

import { Pipe, PipeTransform } from '@angular/core';

@Pipe({
  name: 'reverseText',
  standalone: true
})
export class ReverseTextPipe implements PipeTransform {
  transform(value: string): string {
    return value.split('').reverse().join('');
  }
}

This standalone directive highlights an element with yellow background.

Angular

import { Directive, ElementRef, Renderer2 } from '@angular/core';

@Directive({
  selector: '[highlight]',
  standalone: true
})
export class HighlightDirective {
  constructor(private el: ElementRef, private renderer: Renderer2) {
    this.renderer.setStyle(this.el.nativeElement, 'backgroundColor', 'yellow');
  }
}

Sample Program

This standalone component uses the standalone pipe and directive directly without a module. The text 'hello' is reversed and the heading is highlighted.

Angular

import { Component } from '@angular/core';
import { ReverseTextPipe } from './reverse-text.pipe';
import { HighlightDirective } from './highlight.directive';

@Component({
  selector: 'app-root',
  standalone: true,
  imports: [ReverseTextPipe, HighlightDirective],
  template: `
    <h1 highlight>{{ 'hello' | reverseText }}</h1>
  `
})
export class AppComponent {}

Important Notes

Standalone pipes and directives simplify Angular app structure by removing the need for NgModules.

Remember to add standalone pipes and directives to the imports array of the component using them.

This feature requires Angular 14 or later.

Summary

Standalone pipes and directives work without modules.

Use standalone: true in their decorators.

Import them directly into components for easy reuse.

Practice

1. What does adding standalone: true in an Angular pipe or directive decorator do?

easy

A. It disables the pipe or directive from being used in templates.

B. It allows the pipe or directive to be used without declaring it in an NgModule.

C. It makes the pipe or directive private to the module.

D. It automatically imports the pipe or directive into all components.

Solution

1. Step 1: Understand the role of standalone flag

   The standalone: true flag in Angular marks a pipe or directive so it does not require declaration inside an NgModule.

2. Step 2: Effect on usage

   This means you can import the standalone pipe or directive directly into components without needing a module.

3. Final Answer:

   It allows the pipe or directive to be used without declaring it in an NgModule. -> Option B

4. Quick Check:

   standalone: true means no NgModule needed [OK]

Hint: Standalone means no NgModule declaration needed [OK]

Common Mistakes:

• Thinking standalone makes directive private
• Assuming standalone disables usage
• Believing standalone auto-imports everywhere

2. Which of the following is the correct way to declare a standalone directive in Angular?

easy

A. @Directive({ selector: '[appHighlight]' })

B. @Directive({ selector: '[appHighlight]', standalone: false })

C. @Directive({ selector: 'appHighlight', standalone: true })

D. @Directive({ selector: '[appHighlight]', standalone: true })

Solution

1. Step 1: Check selector syntax

   For attribute directives, the selector must be in square brackets, e.g., '[appHighlight]'.

2. Step 2: Verify standalone flag

   To make a directive standalone, standalone: true must be set in the decorator.

3. Final Answer:

   @Directive({ selector: '[appHighlight]', standalone: true }) -> Option D

4. Quick Check:

   Standalone directive needs selector with [] and standalone: true [OK]

Hint: Standalone directives need standalone: true and correct selector [OK]

Common Mistakes:

• Missing square brackets in selector for attribute directive
• Setting standalone to false or omitting it
• Using element selector instead of attribute selector

3. Given this standalone pipe:

@Pipe({name: 'exclaim', standalone: true})
export class ExclaimPipe implements PipeTransform {
  transform(value: string): string {
    return value + '!';
  }
}

What will be the output of this template?

<div>{{ 'Hello' | exclaim }}</div>

medium

A. Error: Pipe 'exclaim' not found

B. <div>Hello!</div>

C. <div>Hello</div>

D. <div>Hello!!</div>

Solution

1. Step 1: Check pipe declaration and usage

   The pipe is standalone and must be imported into the component using it.

2. Step 2: Analyze template usage without import

   If the component does not import the standalone pipe, Angular will not recognize it, causing an error.

3. Final Answer:

   Error: Pipe 'exclaim' not found -> Option A

4. Quick Check:

   Standalone pipe must be imported to use [OK]

Hint: Standalone pipes need explicit import in component [OK]

Common Mistakes:

• Assuming standalone pipes auto-import
• Expecting output without importing pipe
• Confusing pipe transform logic with usage

4. You have this standalone directive:

@Directive({ selector: '[appColor]', standalone: true })
export class ColorDirective {
  constructor(private el: ElementRef) {
    el.nativeElement.style.color = 'red';
  }
}

When you use <div appColor>Text</div> in a component template but forget to import ColorDirective in the component, what happens?

medium

A. The directive applies but with default styles.

B. The text appears red as expected.

C. Angular throws a template parse error about unknown directive.

D. The app crashes at runtime with a null reference error.

Solution

1. Step 1: Understand standalone directive import

   Standalone directives must be imported into the component's imports array to be recognized.

2. Step 2: Effect of missing import

   If the directive is not imported, Angular does not know about it and throws a template parse error.

3. Final Answer:

   Angular throws a template parse error about unknown directive. -> Option C

4. Quick Check:

   Missing import causes template parse error [OK]

Hint: Always import standalone directives in component imports [OK]

Common Mistakes:

• Assuming directive works without import
• Expecting default styles without directive
• Confusing runtime errors with template errors

5. You want to create a standalone pipe that converts a string to uppercase and use it in multiple components without adding it to any NgModule. Which steps are correct?

1. Add standalone: true in the pipe decorator.
2. Import the pipe in each component's imports array.
3. Declare the pipe in a shared NgModule.
4. Use the pipe in templates after importing.

Choose the correct combination.

hard

A. Steps 1, 2, and 4 only

B. Steps 1 and 3 only

C. Steps 2, 3, and 4 only

D. All steps 1, 2, 3, and 4

Solution

1. Step 1: Understand standalone pipe creation

   Adding standalone: true allows the pipe to be used without NgModule declaration.

2. Step 2: Import in components and use

   Each component that uses the pipe must import it in its imports array and then use it in templates.

3. Step 3: NgModule declaration is unnecessary

   Declaring the pipe in a shared NgModule is not needed and contradicts standalone usage.

4. Final Answer:

   Steps 1, 2, and 4 only -> Option A

5. Quick Check:

   Standalone pipe needs standalone: true, import in components, use in template [OK]

Hint: Standalone pipes skip NgModule, import in components [OK]

Common Mistakes:

• Declaring standalone pipes in NgModules
• Forgetting to import pipe in components
• Assuming usage without import