SmartComponent Library Theming System
The eXperience Package theming system combines runtime Angular services with SCSS build-time assets. Themes are configured through SmartExperiencePackageConfigOptions, resolved and applied by SmartThemeService, persisted via smartframework:theme local storage, and surfaced to users in the Smart Settings dialog. CSS is organized around a reusable base mixin plus per-theme overrides that toggle through <html> classes such as smartcomponents-experience-rounded-light-theme.
- 1 Configuration Surface
- 1.2 Built-in themes
- 1.2.1 Rounded Light
- 1.2.2 Syntra
- 1.2.3 Kendo Default / Fluent
- 1.3 Base Theme Mixin
- 1.4 Creating or Extending a Theme
- 2 Base Theme parameters
- 2.1 Core tokens & shell layout
- 2.2 Smart Components
- 2.2.1 Smart Button
- 2.2.2 Smart Dialogs & Windows
- 2.2.3 Smart Grid & grid pager controls
- 2.2.4 Smart Input controls
- 2.2.5 Smart Split View
- 2.2.6 Smart Tab Folder
- 2.2.7 Smart Toolbar
- 2.2.8 Smart Tree View
- 2.2.9 Smart FAB (Floating Action Button)
- 2.3 eXperience Package components
- 2.3.1 Smart Side Drawer
- 2.3.2 Smart Top bar
Configuration Surface
SmartExperiencePackageConfigOptions
Extends SmartConfig to allow runtime injection of custom themes and window mode defaults.
Theme interface
Defines theme metadata (name, title, optional cssSelector, ActiveReports reportViewerTheme, inheritance link, and arbitrary appConfig).
{
...
"themes": [
{
"name": "rounded-light",
"title": "Rounded Light",
"cssSelector": "smartcomponents-experience-rounded-light-theme",
"reportViewerTheme": {
"primary": "#1c597c",
"type": "light",
"backgroundMain": "#ffffff",
"neutral": "#1c597c",
"secondary": "#1c597c"
},
"appConfig": {
"windowMode": "both"
}
},
{
"name": "custom-theme",
"cssSelector": "custom-theme",
"title": "Custom",
"appConfig": {
"windowMode": "sdi"
}
}
]
}Default options (syntra, rounded-light, kendo-default, fluent) with selectors, report-viewer palettes, and app config fallbacks.
Report Viewer Integration
Every theme can define a reportViewerTheme payload compatible with ActiveReports’ ColorTheme. SmartThemeService.computeSmartReportViewerTheme() merges the theme’s overrides into ColorThemes.Default, ensuring the viewer aligns with UI branding whenever applyTheme() runs.
Built-in themes
Rounded Light
Extends the base mixin with rounded radius, light scheme, button/input sizing, toolbar & grid tweaks, top bar visuals, etc.
Invokes chatbot, release-notes, typography, icon-picker, generic UI control, and grid mixins for cohesive styling.