syncfusion Themes in Syncfusion Angular Components
Syncfusion Angular components provide comprehensive theming support with modern, customizable themes. This skill guides you through applying themes, customizing appearance, implementing dark mode, using CSS variables, managing icons, and creating custom themes for consistent, professional Angular applications.
Table of Contents
Documentation and Navigation Guide
Built-in Themes
📄 Read: references/built-in-themes.md
- Available 10+ themes
- Applying themes via npm packages, CDN, or individual component styles
- Optimized (lite) CSS files for reduced bundle size
Dark Mode Implementation
📄 Read: references/dark-mode.md
- Global dark mode with
e-dark-modeclass - Per-component dark mode
- Runtime theme switching with checkboxes or toggle buttons
CSS Variables Customization
📄 Read: references/css-variables.md
- CSS variable structure for each theme (Material 3, Fluent 2, Bootstrap 5.3, Tailwind 3.4)
- Customizing primary, success, warning, danger, info colors
- Runtime color modification with TypeScript
- Theme-specific variable formats (RGB vs hex values)
Icon Library
📄 Read: references/icons.md
- Setting up the icon library (npm or CDN)
- Using icons with
e-iconsclass - Icon sizing (small, medium, large)
- Customizing icon color and appearance
- Available icon sets per theme
Size Modes
📄 Read: references/advanced-theming.md
- Normal vs touch (bigger) size modes
- Enabling size modes globally or per-component
- Runtime size mode switching
Advanced Features
📄 Read: references/advanced-theming.md
- Component styling integration
- Theme Studio for custom theme creation
Migrating Styles from Component Packages to Theme Packages
📄 Read: references/migration-styles.md
- Migrate from component packages to theme packages
- SCSS & CSS Reference migration to theme packages
- Automatic dependency inclusion via index files
Quick Start
Install and Apply a Theme
Step 1: Install Syncfusion Angular Package and theme package
npm install @syncfusion/ej2-angular-buttons@latest @syncfusion/ej2-tailwind3-theme@latest --save
Step 2: Import Theme CSS
Option 1: Import from npm (Recommended)
/* src/styles.css */
@import "../node_modules/@syncfusion/ej2-tailwind3-theme/styles/button/index.css";
Option 2: Use CDN
To find your installed version:
npm list @syncfusion/ej2-angular-buttons
Then use the matching CDN version:
<!-- angular.json - Add to styles array -->
"styles": [
"https://cdn.syncfusion.com/ej2/33.1.44/tailwind3.css"
]
⚠️ Important: The CDN version MUST match your installed npm package version to avoid style and rendering issues.
Note: Using npm imports (Option 1) is recommended as it automatically keeps CSS and JavaScript versions in sync.
Common Patterns
Pattern 1: Apply Dark Mode Globally
import { Component, OnInit } from '@angular/core';
@Component({
selector: 'app-root',
template: `
<div>
<ejs-checkbox
label="Enable Dark Mode"
[checked]="isDarkMode"
(change)="handleDarkModeToggle($event)">
</ejs-checkbox>
<ejs-button cssClass="e-primary">Sample Button</ejs-button>
</div>
`
})
export class AppComponent {
isDarkMode = false;
handleDarkModeToggle(event: any): void {
this.isDarkMode = event.checked ?? false;
if (this.isDarkMode) {
document.body.classList.add('e-dark-mode');
} else {
document.body.classList.remove('e-dark-mode');
}
}
}
Pattern 2: Customize Primary Color with CSS Variables
For Fluent 2 Theme:
/* src/styles.css */
:root {
--color-sf-primary: #ff6b35; /* Custom orange */
}
For Material 3 Theme (uses RGB values):
/* src/styles.css */
:root {
--color-sf-primary: 255, 107, 53; /* RGB: Custom orange */
}
Pattern 3: Enable Touch Mode Globally
<!-- index.html -->
<body class="e-bigger">
<app-root></app-root>
</body>
Or per-component:
<ejs-button cssClass="e-bigger">Touch-Friendly Button</ejs-button>
Pattern 4: Use Optimized CSS for Faster Loading
/* src/styles.css - Lite version without bigger mode styles */
@import "@syncfusion/ej2-tailwind3-theme/styles/tailwind3-lite.css";
Pattern 5: Use Icons from Syncfusion Library
Install icons package:
You can install either the icons package or the theme package:
npm install @syncfusion/ej2-icons@latest
/* or */
npm install @syncfusion/ej2-tailwind3-theme@latest
Import icon styles:
/* src/styles.css */
/* Syncfusion theme package icon styles */
@import "../node_modules/@syncfusion/ej2-tailwind3-theme/styles/icons/tailwind3.css";
/* or */
/* Syncfusion components package icon styles */
@import "../node_modules/@syncfusion/ej2-icons/styles/tailwind3.css";
Use icons in components:
<span class="e-icons e-cut"></span>
<span class="e-icons e-medium e-copy"></span>
<span class="e-icons e-large e-paste"></span>