Syncfusion Angular 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

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

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

Common Use Cases

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