syncfusion-angular-notifications

name	syncfusion-angular-notifications
description	Comprehensive guide for implementing Syncfusion Angular notification components including Message, Skeleton, Toast, and Badge. Use this when displaying informational, success, warning, or error alerts with severity levels, customizing message variants (Text, Outlined, Filled), handling close events, showing content skeletons with shimmer/pulse animations during data loading, or adding status badges with 8 color variants and shape types (circle, pill, notification, dot, overlap). Covers MessageModule, SkeletonModule, ToastModule, CSS-based Badge implementation, accessibility, RTL, and custom styling in Angular applications.
metadata	{"author":"Syncfusion Inc","version":"33.1.44","category":"Notifications"}

Implementing Syncfusion Angular Notifications

---

Message

The Syncfusion Angular Message component (ejs-message) displays contextual messages with severity-based icons and colors to communicate importance to the user. It supports multiple severity types, visual variants, close icon, custom templates, content alignment, CSS customization, and full accessibility compliance.

Package: @syncfusion/ej2-angular-notifications
Module: MessageModule
Selector: ejs-message

---

📋 All files linked under references/ are read-only documentation and comply with the same security policy as this skill.

Navigation Guide

Getting Started

📄 Read: references/message-getting-started.md

• Installing @syncfusion/ej2-angular-notifications via ng add
• CSS/SCSS theme imports (Material3)
• MessageModule import in standalone component
• Minimal ejs-message template setup
• Running the application

Severity Types

📄 Read: references/message-severities.md

• severity property with all five values: Normal, Success, Info, Warning, Error
• Default severity (Normal)
• When to choose each severity type
• Code example with all severities

Visual Variants

📄 Read: references/message-variants.md

• variant property: Text, Outlined, Filled
• Default variant (Text)
• Combining variant with severity
• Full example showing all combinations

Icons and Close Icon

📄 Read: references/message-icons.md

• showIcon — hide/show the severity icon
• showCloseIcon — add a close icon to dismiss messages
• (closed) event — react when user closes a message
• Restoring visibility with visible property
• Custom icon using cssClass

Customization and Templates

📄 Read: references/message-customization.md

• Content alignment: left (default), center (e-content-center), right (e-content-right)
• Rounded and square border styles via cssClass
• CSS-only message rendering (no script reference)
• Predefined CSS classes for manual DOM structure
• Rich HTML template via <ng-template #content>

Accessibility

📄 Read: references/message-accessibility.md

• WCAG 2.2 / Section 508 compliance
• WAI-ARIA attributes (role=alert, aria-label)
• Keyboard interaction (Tab, Enter/Space for close icon)
• RTL support via enableRtl
• Screen reader behavior

API Reference

📄 Read: references/message-api.md

• All properties: content, cssClass, enablePersistence, enableRtl, locale, severity, showCloseIcon, showIcon, variant, visible
• Methods: destroy(), getPersistData()
• Events: closed, created, destroyed

---

Quick Start

ng add @syncfusion/ej2-angular-notifications

/* styles.css – added automatically by ng add */
/* NOTE: These are consumer-side stylesheet references only; no packages are installed or executed by this skill. */
@import '../node_modules/@syncfusion/ej2-base/styles/material3.css';
@import '../node_modules/@syncfusion/ej2-angular-notifications/styles/message/material3.css';

import { MessageModule } from '@syncfusion/ej2-angular-notifications';
import { Component } from '@angular/core';

@Component({
  imports: [MessageModule],
  standalone: true,
  selector: 'app-root',
  template: '<ejs-message content="Please read the comments carefully"></ejs-message>'
})
export class AppComponent { }

---

Common Patterns

Message with Severity

import { MessageModule } from '@syncfusion/ej2-angular-notifications';
import { Component } from '@angular/core';

@Component({
  imports: [MessageModule],
  standalone: true,
  selector: 'app-root',
  template: `
    <ejs-message content="Editing is restricted"></ejs-message>
    <ejs-message content="Please read the comments carefully" severity="Info"></ejs-message>
    <ejs-message content="Your message has been sent successfully" severity="Success"></ejs-message>
    <ejs-message content="There was a problem with your network connection" severity="Warning"></ejs-message>
    <ejs-message content="A problem occurred while submitting your data" severity="Error"></ejs-message>
  `
})
export class AppComponent { }

Dismissable Message with Close Icon

import { MessageModule } from '@syncfusion/ej2-angular-notifications';
import { Component, ViewChild } from '@angular/core';
import { MessageComponent } from '@syncfusion/ej2-angular-notifications';

@Component({
  imports: [MessageModule],
  standalone: true,
  selector: 'app-root',
  template: `
    <ejs-message #msg severity="Warning" [showCloseIcon]="true" (closed)="onClosed()">
      There was a problem with your network connection
    </ejs-message>
    <button *ngIf="isClosed" (click)="reopen()">Show again</button>
  `
})
export class AppComponent {
  @ViewChild('msg') msg!: MessageComponent;
  isClosed = false;

  onClosed(): void {
    this.isClosed = true;
  }

  reopen(): void {
    this.msg.visible = true;
    this.isClosed = false;
  }
}

Filled Variant with Severity

import { MessageModule } from '@syncfusion/ej2-angular-notifications';
import { Component } from '@angular/core';

@Component({
  imports: [MessageModule],
  standalone: true,
  selector: 'app-root',
  template: `
    <ejs-message content="Your message has been sent successfully"
      severity="Success" variant="Filled">
    </ejs-message>
  `
})
export class AppComponent { }

---

Key Props at a Glance

Property	Type	Default	Purpose
content	string | object	null	Text, HTML, or template content to display
severity	string	'Normal'	Severity type: Normal, Success, Info, Warning, Error
variant	string	'Text'	Visual style: Text, Outlined, Filled
showIcon	boolean	true	Show/hide the severity icon
showCloseIcon	boolean	false	Show/hide the close icon
visible	boolean	true	Show or hide the entire message
cssClass	string	''	Custom CSS class(es) appended to root element
enableRtl	boolean	false	Right-to-left rendering
enablePersistence	boolean	false	Persist component state across page reloads
locale	string	''	Override global culture/localization

---

Skeleton

The Skeleton component provides a visual placeholder for content that is loading or yet to be rendered. It helps improve perceived performance by showing users what content is coming, reducing cognitive load during loading states.

Package: @syncfusion/ej2-angular-notifications
Module: SkeletonModule
Selector: ejs-skeleton

📋 All files linked under references/ are read-only documentation and comply with the same security policy as this skill.

Navigation Guide

Getting Started

📄 Read: references/skeleton-getting-started.md

• Installation and package setup
• Dependencies and CSS imports
• Basic skeleton implementation
• Angular 19+ standalone architecture
• Running your application with Skeleton

Shapes and Layout Design

📄 Read: references/skeleton-shapes.md

• Circle shapes for avatars and profile pictures
• Square shapes for thumbnails and icons
• Rectangle shapes for images and cards
• Text shapes for paragraphs and content
• Combining shapes to build complete layouts
• Responsive sizing and responsive design

Shimmer Effects and Animation

📄 Read: references/skeleton-shimmer-effects.md

• Wave effect (default animation)
• Pulse effect (fade in/out animation)
• Fade effect (opacity change animation)
• Changing effects dynamically
• Performance considerations for multiple skeletons

Styling and Customization

📄 Read: references/skeleton-styles-customization.md

• Using cssClass for custom styling
• Customizing wave/background colors
• Setting width and height dimensions
• Controlling visibility with the visible property
• CSS variables for theming
• Theme Studio integration

Accessibility Features

📄 Read: references/skeleton-accessibility.md

• WCAG 2.2 and Section 508 compliance
• Screen reader support and live regions
• WAI-ARIA attributes (role, aria-label, aria-live, aria-busy)
• Right-to-Left (RTL) support
• Keyboard navigation and focus management
• Color contrast requirements
• Accessibility validation tools

API Reference

📄 Read: references/skeleton-api.md

• All properties with descriptions and defaults
• Methods and lifecycle management
• Event handling patterns
• Type definitions (SkeletonType, ShimmerEffect)
• Property usage examples
• Complete API documentation

---

Quick Start

import { Component } from '@angular/core';
import { SkeletonModule } from '@syncfusion/ej2-angular-notifications';

@Component({
  imports: [SkeletonModule],
  standalone: true,
  selector: 'app-root',
  template: `
    <div>
      <h2>Loading User Profile...</h2>
      <!-- Avatar skeleton -->
      <ejs-skeleton shape="Circle" width="60px"></ejs-skeleton>
      
      <!-- Name and description skeletons -->
      <ejs-skeleton width="30%" height="15px"></ejs-skeleton>
      <ejs-skeleton width="50%" height="15px"></ejs-skeleton>
      
      <!-- Content skeleton -->
      <ejs-skeleton shape="Rectangle" width="100%" height="150px"></ejs-skeleton>
    </div>
  `
})
export class AppComponent {}

---

Common Patterns

Pattern 1: Card Loading Skeleton

Display a skeleton layout matching a card component during data loading:

@Component({
  selector: 'app-card-skeleton',
  template: `
    <div class='card-skeleton'>
      <!-- Avatar -->
      <div class='avatar-section'>
        <ejs-skeleton shape="Circle" width="50px"></ejs-skeleton>
      </div>
      <!-- Content -->
      <div class='content-section'>
        <ejs-skeleton width="60%" height="12px"></ejs-skeleton>
        <ejs-skeleton width="40%" height="12px"></ejs-skeleton>
        <ejs-skeleton width="100%" height="80px"></ejs-skeleton>
      </div>
      <!-- Actions -->
      <div class='action-section'>
        <ejs-skeleton shape="Rectangle" width="30%" height="36px"></ejs-skeleton>
      </div>
    </div>
  `
})
export class CardSkeletonComponent {}

Pattern 2: List Loading with Pulse Effect

Show multiple skeleton rows with a pulsing shimmer effect:

@Component({
  selector: 'app-list-skeleton',
  template: `
    <div class='list-skeleton'>
      <div class='list-item' *ngFor="let item of [1,2,3,4,5]">
        <ejs-skeleton shape="Circle" width="40px" shimmerEffect="Pulse"></ejs-skeleton>
        <div class='item-content'>
          <ejs-skeleton width="50%" height="14px" shimmerEffect="Pulse"></ejs-skeleton>
          <ejs-skeleton width="30%" height="12px" shimmerEffect="Pulse"></ejs-skeleton>
        </div>
      </div>
    </div>
  `
})
export class ListSkeletonComponent {}

Pattern 3: Conditional Skeleton Rendering

Show skeleton while loading, hide when content is ready:

@Component({
  selector: 'app-conditional-skeleton',
  template: `
    <!-- Show skeleton while loading -->
    <div *ngIf="isLoading">
      <ejs-skeleton shape="Rectangle" width="100%" height="200px" 
                    shimmerEffect="Wave"></ejs-skeleton>
    </div>
    <!-- Show content when loaded -->
    <div *ngIf="!isLoading">
      <img [src]="imageUrl" alt="Loaded content">
    </div>
  `
})
export class ConditionalSkeletonComponent {
  isLoading = true;
  imageUrl = '';
  
  ngOnInit() {
    // Simulate loading
    setTimeout(() => {
      this.isLoading = false;
      this.imageUrl = 'assets/image.jpg';
    }, 2000);
  }
}

---

Key Properties

Property	Type	Default	Purpose
shape	SkeletonType	'Text'	Defines skeleton shape: Text, Circle, Square, Rectangle
shimmerEffect	ShimmerEffect	'Wave'	Animation effect: Wave, Pulse, Fade
width	string | number	''	Skeleton width (required for Circle/Square)
height	string | number	''	Skeleton height
visible	boolean	true	Controls skeleton visibility
cssClass	string	''	Custom CSS class for styling
label	string	'Loading…'	Aria-label for accessibility
enableRtl	boolean	false	Enable right-to-left layout
enablePersistence	boolean	false	Persist state between page reloads

Common Use Cases

1. Data Grid Loading: Show skeleton rows while grid data is loading from server
2. Image Gallery: Display placeholder rectangles while images download
3. Feed/Timeline: Show multiple skeleton cards while loading feed items
4. Profile Page: Combine shapes to preview profile layout
5. List with Avatars: Use Circle + Text shapes for user lists
6. Modal Content: Display skeleton inside dialogs during async operations
7. Product Cards: Build skeleton matching product card layout
8. Dashboard: Create skeleton layouts for dashboard widgets

Toast

The Syncfusion Angular Toast (ejs-toast) is a non-blocking notification component that displays brief messages at a defined position on the screen. Toasts auto-dismiss after a configurable timeout and support rich content via templates, action buttons, icons, and progress bars.

Navigation Guide

Getting Started

📄 Read: references/getting-started.md

• Prerequisites and dependencies
• Installing @syncfusion/ej2-angular-notifications
• Adding CSS/theme imports
• Basic toast setup (standalone + NgModule)
• Showing a toast on component creation
• Running the application

Configuration

📄 Read: references/configuration.md

• Title and content properties
• Custom target container
• Show/hide close button (showCloseButton)
• Progress bar (showProgressBar, progressDirection)
• Newest on top (newestOnTop)
• Width and height customization
• Icon using icon property
• cssClass for semantic types (e-success, e-info, e-warning, e-danger)
• enableHtmlSanitizer, enableRtl, locale

Position and Animation

📄 Read: references/position-and-animation.md

• Predefined X/Y positions (Left, Center, Right / Top, Bottom)
• Custom pixel/percentage positions
• Multiple toasts in different positions
• Animation configuration (show/hide effects, duration, easing)
• Default animation (FadeIn/FadeOut)

Templates and Action Buttons

📄 Read: references/template-and-buttons.md

• HTML string and element ID templates
• Angular ng-template with #template, #title, #content
• Dynamic templates via show() method arguments
• Action buttons with buttons property and click handlers
• ButtonModelPropsModel configuration

Timeout and Events

📄 Read: references/timeout-and-events.md

• timeOut property (default 5000ms)
• extendedTimeout on hover (default 1000ms)
• Static toast (timeOut: 0)
• All events: created, open, close, click, beforeOpen, beforeClose, beforeSanitizeHtml, destroyed
• Event argument types and cancellation patterns

Toast Utility Service

📄 Read: references/toast-utility.md

• ToastUtility.show() for minimal-code toasts
• Predefined types: Information, Success, Error, Warning
• Full ToastModel argument usage with events and positioning
• When to use utility vs component approach

How-To Guides

📄 Read: references/how-to.md

• Close toast on click/tap
• Prevent duplicate toasts
• Restrict maximum visible toasts
• Add dynamic templates
• Render Angular ng-template in toast
• Show multiple toasts in various positions
• Customize progress bar theme and sizing
• Play audio before toast opens
• Prevent toast close with mobile swipe
• Show different types of toast

API Reference

📄 Read: references/api.md

• All properties with types and defaults
• Methods: show(), hide(), destroy()
• All events with argument type links
• ToastAnimationSettingsModel, ToastPositionModel, ButtonModelPropsModel

---

Quick Start

// app.ts (Angular standalone)
import { Component, ViewChild } from '@angular/core';
import { ToastModule } from '@syncfusion/ej2-angular-notifications';

@Component({
  imports: [ToastModule],
  standalone: true,
  selector: 'app-root',
  template: `
    <ejs-toast #toast (created)="onCreated()">
      <ng-template #title><div>Notification</div></ng-template>
      <ng-template #content><div>Your action was successful.</div></ng-template>
    </ejs-toast>
    <button (click)="toast.show()">Show Toast</button>
  `
})
export class App {
  @ViewChild('toast') toast: any;
  onCreated() { this.toast.show(); }
}

Install:

ng add @syncfusion/ej2-angular-notifications

CSS (styles.css):

@import '@syncfusion/ej2-base/styles/material3.css';
@import '@syncfusion/ej2-buttons/styles/material3.css';
@import '@syncfusion/ej2-popups/styles/material3.css';
@import '@syncfusion/ej2-angular-notifications/styles/material3.css';

---

Common Patterns

Success/Error/Warning/Info Toast

// Using cssClass for semantic coloring
toastObj.show({ content: 'File saved!', cssClass: 'e-toast-success' });
toastObj.show({ content: 'Upload failed.', cssClass: 'e-toast-danger' });
toastObj.show({ content: 'Low disk space.', cssClass: 'e-toast-warning' });
toastObj.show({ content: 'Update available.', cssClass: 'e-toast-info' });

Quick Toast via ToastUtility

import { ToastUtility } from '@syncfusion/ej2-angular-notifications';
ToastUtility.show('Operation successful', 'Success', 3000);

Toast with Progress Bar + Close Button

<ejs-toast [showProgressBar]="true" [showCloseButton]="true" [timeOut]="4000">
</ejs-toast>

Toast Positioned Bottom-Center

public position = { X: 'Center', Y: 'Bottom' };

<ejs-toast [position]="position"></ejs-toast>

Action Buttons

public buttons = [
  { model: { content: 'Undo' }, click: () => this.onUndo() },
  { model: { content: 'Dismiss' } }
];

Static Toast (no auto-dismiss)

<ejs-toast [timeOut]="0" [showCloseButton]="true"></ejs-toast>

---

Key Properties

Property	Type	Default	Purpose
title	any	null	Toast heading text or HTML
content	any	null	Toast body text or HTML
timeOut	number	5000	Auto-dismiss after ms (0 = static)
position	ToastPositionModel	{X:'Left',Y:'Top'}	Screen position
showCloseButton	boolean	false	Show × dismiss button
showProgressBar	boolean	false	Show countdown progress bar
progressDirection	string	'Rtl'	Progress bar direction (Ltr/Rtl)
newestOnTop	boolean	true	Insert new toasts before old ones
cssClass	string	null	Custom CSS classes
icon	string	null	CSS class for top-left icon
target	string/Element	null	Container element (default: body)
width	string/number	'300'	Toast width
height	string/number	'auto'	Toast height
buttons	ButtonModelPropsModel[]	[{}]	Action buttons
animation	ToastAnimationSettingsModel	FadeIn/FadeOut	Show/hide animation
extendedTimeout	number	1000	Extra time on hover
enableRtl	boolean	false	Right-to-left rendering

---

Common Use Cases

Scenario	Approach
Simple one-liner notification	Use ToastUtility.show()
Typed notification (success/error)	cssClass: 'e-toast-success' or ToastUtility.show(..., 'Success', ...)
Notification requiring user action	Add buttons array with click handlers
Persistent alert until dismissed	Set timeOut: 0 + showCloseButton: true
Multiple simultaneous toasts	Use separate ejs-toast instances with different target containers
Notification in custom container	Set target property to element reference or selector
Prevent duplicate messages	Cancel in beforeOpen event if same title already visible
Mobile-friendly (no swipe dismiss)	Cancel beforeClose when args.type === 'swipe'
Progress indicator	showProgressBar: true, customize via beforeOpen event

Badge

The Syncfusion Angular Badge is a pure CSS component — no Angular component class to import. Badges are applied by adding CSS modifier classes to a <span> (or <a>) element nested inside the target UI element.

Package: @syncfusion/ej2-angular-notifications

Key Features

• 8 color variants — primary, secondary, success, danger, warning, info, light, dark
• Shape types — circle, pill, link, notification, dot, overlap
• Positioning — top (default) and bottom placement on parent elements
• Customization — custom colors, sizes, and arbitrary positions via CSS
• ListView integration — embed badges in list items with dynamic content

Navigation Guide

Getting Started

📄 Read: references/getting-started.md

• Package installation and CSS imports
• Adding the first badge to an Angular component
• Minimal working example
• Running the application

Badge Types and Shapes

📄 Read: references/types-and-shapes.md

• 8 predefined color variants and their semantic purpose
• Circle, pill, link, notification, dot, overlap shape types
• Badge positioning (top vs bottom)
• When to combine modifier classes (e.g., overlap + notification + circle)

Customization

📄 Read: references/customization.md

• Custom color overrides with CSS classes
• Adjusting badge size via font-size
• Custom positioning (left-top, left-bottom) with CSS overrides
• When to use custom CSS vs built-in modifier classes

How-To Guides

📄 Read: references/how-to.md

• Integrate badges into a ListView component
• Update badge content dynamically (increment counts)
• Angular pattern for badge state management using DOM updates

Quick Start

1. Install the package:

npm install @syncfusion/ej2-angular-notifications --save

2. Add CSS to src/styles.css:

@import "../node_modules/@syncfusion/ej2-base/styles/tailwind3.css";
@import "../node_modules/@syncfusion/ej2-notifications/styles/tailwind3.css";

3. Add a badge in your component:

<!-- src/app/app.component.html -->
<h1>Badge Component <span class="e-badge e-badge-primary">New</span></h1>

Common Patterns

Notification badge on an icon

<!-- Parent must have position: relative -->
<div class="badge-block">
  <div class="skype svg_icons"></div>
  <span class="e-badge e-badge-success e-badge-overlap e-badge-notification">99+</span>
</div>

Dot status indicator (bottom position)

<div class="badge-block">
  <div class="firefox svg_icons"></div>
  <span class="e-badge e-badge-success e-badge-overlap e-badge-dot e-badge-bottom"></span>
</div>

Pill-shaped label

<h1>Messages <span class="e-badge e-badge-primary e-badge-pill">New</span></h1>

CSS Class Reference

Class	Purpose
e-badge	Required base class for all badges
e-badge-primary / e-badge-{color}	Color variant
e-badge-pill	Pill (rounded rectangle) shape
e-badge-circle	Circle shape
e-badge-notification	Notification counter badge
e-badge-dot	Minimalist dot badge (no text)
e-badge-overlap	Overlaps the parent element edge
e-badge-bottom	Positions badge at bottom instead of top