syncfusion-javascript-themes

Themes in Syncfusion JavaScript Controls

Syncfusion JavaScript controls 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 JavaScript applications.

Table of Contents

• Documentation and Navigation Guide
• Quick Start
• Common Patterns

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-mode class
• 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 JavaScript
• 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-icons class
• 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

• Font customization across all controls
• 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 JavaScript Package and theme package

npm install @syncfusion/ej2-buttons @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

⚠️ Important: The CDN version MUST match your installed npm package version to avoid style and rendering issues.

To find your installed version:

npm list @syncfusion/ej2-buttons

Then use the matching CDN version:

<!-- index.html -->
<!-- Replace {VERSION} with your installed package version (e.g., 28.1.33, 33.1.44) -->
<link href="https://cdn.syncfusion.com/ej2/{VERSION}/tailwind3.css" rel="stylesheet"/>

<!-- Example: If your package version is 33.1.44 -->
<link href="https://cdn.syncfusion.com/ej2/33.1.44/tailwind3.css" rel="stylesheet"/>

Note: Using npm imports (Option 1) is recommended as it automatically keeps CSS and JavaScript versions in sync.

Common Patterns

Apply Dark Mode Globally

import { CheckBox } from '@syncfusion/ej2-buttons';
import { Button } from '@syncfusion/ej2-buttons';

// Initialize dark mode checkbox
const darkModeCheckBox: CheckBox = new CheckBox({
  label: 'Enable Dark Mode',
  change: (args) => {
    const isChecked: boolean = args.checked ?? false;
    
    if (isChecked) {
      document.body.classList.add('e-dark-mode');
    } else {
      document.body.classList.remove('e-dark-mode');
    }
  }
});
darkModeCheckBox.appendTo('#darkModeCheckbox');

// Initialize sample button
const button: Button = new Button({
  cssClass: 'e-primary',
  content: 'Sample Button'
});
button.appendTo('#sampleButton');

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 */
}

Enable Touch Mode Globally

<!-- index.html -->
<body class="e-bigger">
  <div id="app"></div>
</body>

Or per-component:

import { Button } from '@syncfusion/ej2-buttons';

const button: Button = new Button({
  cssClass: 'e-bigger',
  content: 'Touch-Friendly Button'
});
button.appendTo('#button');

Use Optimized CSS for Faster Loading

/* src/styles.css - Lite version without bigger mode styles */
@import "@syncfusion/ej2-tailwind3-theme/styles/tailwind3-lite.css";

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 control package icon styles */
@import "../node_modules/@syncfusion/ej2-icons/styles/tailwind3.css";

Use icons in HTML:

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