• Overview
@angular/common

NgSwitchCase

directive

Provides a switch case expression to match against an enclosing ngSwitch expression. When the expressions match, the given NgSwitchCase template is rendered. If multiple match expressions match the switch expression value, all of them are displayed.

API

  
    class NgSwitchCase implements DoCheck {}
  
  

ngSwitchCase

any

Stores the HTML template to be selected on match.

ngDoCheck

void

Performs case matching. For internal use only.

@returnsvoid

Description

Provides a switch case expression to match against an enclosing ngSwitch expression. When the expressions match, the given NgSwitchCase template is rendered. If multiple match expressions match the switch expression value, all of them are displayed.


Exported by

Usage Notes

Within a switch container, *ngSwitchCase statements specify the match expressions as attributes. Include *ngSwitchDefault as the final case.

          
<container-element [ngSwitch]="switch_expression">  <some-element *ngSwitchCase="match_expression_1">...</some-element>  ...  <some-element *ngSwitchDefault>...</some-element></container-element>

Each switch-case statement contains an in-line HTML template or template reference that defines the subtree to be selected if the value of the match expression matches the value of the switch expression.

As of Angular v17 the NgSwitch directive uses strict equality comparison (===) instead of loose equality (==) to match different cases.

Jump to details