Themes and Styles for a JavaScript Application

• May 14, 2023
• 6 minutes to read

Supported Themes

You can apply two types of themes to a Web Dashboard:

Predefined themes

You can find the complete list in the table below. All the listed options are different modifications of the Generic, Generic Compact, and Material Design Compact DevExtreme themes.

Custom themes

You can modify Generic and Generic Compact DevExtreme themes. This topic includes step-by-step instructions on theme customization.

Each theme is a collection of CSS files (stylesheets).

Generic Themes

Image	Demo	CSS File (Generic)	CSS File (Generic Compact)
	Light	dx.light.css dx-analytics.light.css dx-dashboard.light.css	dx.light.compact.css dx-analytics.light.compact.css dx-dashboard.light.compact.css
	Dark	dx.dark.css dx-analytics.dark.css dx-dashboard.dark.css	dx.dark.compact.css dx-analytics.dark.compact.css dx-dashboard.dark.compact.css
	Carmine	dx.carmine.css dx-analytics.carmine.css dx-dashboard.carmine.css	dx.carmine.compact.css dx-analytics.carmine.compact.css dx-dashboard.carmine.compact.css
	Soft Blue	dx.softblue.css dx-analytics.softblue.css dx-dashboard.softblue.css	dx.softblue.compact.css dx-analytics.softblue.compact.css dx-dashboard.softblue.compact.css
	Green Mist	dx.greenmist.css dx-analytics.greenmist.css dx-dashboard.greenmist.css	dx.greenmist.compact.css dx-analytics.greenmist.compact.css dx-dashboard.greenmist.compact.css
	Dark Moon	dx.darkmoon.css dx-analytics.darkmoon.css dx-dashboard.darkmoon.css	dx.darkmoon.compact.css dx-analytics.darkmoon.compact.css dx-dashboard.darkmoon.compact.css
	Dark Violet	dx.darkviolet.css dx-analytics.darkviolet.css dx-dashboard.darkviolet.css	dx.darkviolet.compact.css dx-analytics.darkviolet.compact.css dx-dashboard.darkviolet.compact.css

Material Design Themes

Image	Demo	CSS File (Material Design Compact)
	Blue Light	dx.material.blue.light.compact.css dx-analytics.material.blue.light.compact.css dx-dashboard.material.blue.light.compact.css
	Lime Light	dx.material.lime.light.compact.css dx-analytics.material.lime.light.compact.css dx-dashboard.material.lime.light.compact.css
	Orange Light	dx.material.orange.light.compact.css dx-analytics.material.orange.light.compact.css dx-dashboard.material.orange.light.compact.css
	Purple Light	dx.material.purple.light.compact.css dx-analytics.material.purple.light.compact.css dx-dashboard.material.purple.light.compact.css
	Teal Light	dx.material.teal.light.compact.css dx-analytics.material.teal.light.compact.css dx-dashboard.material.teal.light.compact.css
	Blue Dark	dx.material.blue.dark.compact.css dx-analytics.material.blue.dark.compact.css dx-dashboard.material.blue.dark.compact.css
	Lime Dark	dx.material.lime.dark.compact.css dx-analytics.material.lime.dark.compact.css dx-dashboard.material.lime.dark.compact.css
	Orange Dark	dx.material.orange.dark.compact.css dx-analytics.material.orange.dark.compact.css dx-dashboard.material.orange.dark.compact.css
	Purple Dark	dx.material.purple.dark.compact.css dx-analytics.material.purple.dark.compact.css dx-dashboard.material.purple.dark.compact.css
	Teal Dark	dx.material.teal.dark.compact.css dx-analytics.material.teal.dark.compact.css dx-dashboard.material.teal.dark.compact.css

Apply a Built-in Theme

Use the CSS files that correspond to the predefined theme you want to apply. The code snippet below shows how to enable the Carmine theme:

<!-- ... -->
<link href="node_modules/devextreme-dist/css/dx.carmine.css" rel="stylesheet" />
<link href="node_modules/@devexpress/analytics-core/dist/css/dx-analytics.common.css" rel="stylesheet" />
<link href="node_modules/@devexpress/analytics-core/dist/css/dx-analytics.carmine.css" rel="stylesheet" />
<link href="node_modules/@devexpress/analytics-core/dist/css/dx-querybuilder.css" />
<link href="node_modules/devexpress-dashboard/dist/css/dx-dashboard.carmine.css" rel="stylesheet" />

Customize Themes

Warning

Customization is available only for Generic and Generic Compact themes.

The DevExpress Dashboard CLI is used with the DevExtreme ThemeBuilder to create a custom theme for the Web Dashboard.

Theme customization involves the following basic steps:

1. Use the DevExtreme ThemeBuilder tool to customize an existing theme and export the results.
2. Add Dashboard-specific settings to the generated resource files.
3. Use the DevExpress Dashboard CLI to convert the customized resource files into a Web Dashboard theme.
4. Register the new theme in your application.

Create a Custom Theme

1. Make sure you have Node.js and npm installed on your machine.
2. Open the ThemeBuilder. Create a custom theme based on Generic themes. For instance, you can use the Light theme as a base and change its accent color from blue (#337ab7) to yellow (#fdb400).
3. Set the color scheme name (for example, “light-yellow”) and use the Export Metadata → Download Metadata File button to export metadata in a JSON format.
4. Copy the downloaded JSON file (dx.generic.light-yellow.json) to an empty folder.

5. Edit dx.generic.light-yellow.json and add the dashboardItems property to override the accent colors at the dashboard level:

   {
       "items": [
           {
               "key": "@base-accent",
               "value": "#fdb400"
           }
       ],   
       "dashboardItems": [  
           { 
               "key": "@dashboard-item-selected-bg", 
               "value": "rgba(#fdb400, 0.2)" 
           },
           { 
               "key": "@dashboard-item-hover-bg", 
               "value": "rgba(#fdb400, 0.1)" 
           } 
       ],
       "baseTheme": "generic.light",
       "outputColorScheme": "light-yellow",
       "makeSwatch": false,
       "version": "24.1.7",
       "widgets": [],
       "removeExternalResources": false
   }
   

   Refer to the Color Constants section to see a list of available color constants you can use to customize Web Dashboard colors.

6. In the folder you created in Step 4, execute the command that installs the devexpress-dashboard-cli package and builds the CSS files for your custom JSON file. Use the same version of the devexpress-dashboard-cli package as the version of DevExpress packages that you use in your application:

   npx devexpress-dashboard-cli@24.1.7 build-theme --input-file dx.generic.light-yellow.json
   

   This generates the following CSS files and their minified versions:

   • dx.light-yellow.css
   • dx-analytics.light-yellow.css
   • dx-dashboard.light-yellow.css
   • dx.light-yellow.min.css
   • dx-analytics.light-yellow.min.css
   • dx-dashboard.light-yellow.min.css

   Warning

   The devexpress-dashboard-cli package version should match the version of other DevExpress packages used in your application. To check the version for which you generated the CSS files, open the dx-dashboard.<theme-name>.css file and find the version number in the comments.

Color Constants

The Web Dashboard uses color constants to paint the control’s elements. The colors of the color constants listed in the table below can be customized. Changes to specific dashboard elements’ colors do not affect the basic DevExtreme colors.

Show Table

Color Constant	Description
@dashboard-surface-bg	The background color of the dashboard surface.
@dashboard-item-selected-bg	The background color of the selected element in a dashboard item.
@dashboard-item-hover-bg	The background color applied to elements in a dashboard item when you hover over them.
@dashboard-overlay-shader-bg	The shading background color.
@dashboard-border-color	A more contrast border color.
@dashboard-border-sub-color	A less contrast border color.
@dashboard-shadow	The color of the shadow used for the control’s elements (for example, when you hover over icons in the Toolbox).
@dashboard-shadow-border-color	The color of the border that appears with the shadow.
@dashboard-tab-hover-bg	The background color of the inactive hovered tab page’s header.
@dashboard-tab-inactive-bg	The background color of the inactive tab page.
@dashboard-info-toast-bg	The background color of the information notification toast.
@dashboard-info-toast-color	The text color of the information notification toast.
@dashboard-error	The background color of the error notification toast.
@dashboard-success	The background color of the success notification toast.
@dashboard-item-menu-bg	The background color of the dashboard item menu.
@dashboard-item-menu-icon-color	The primary color of the dashboard item menu’s icons.
@dashboard-item-menu-icon-sub-color	The additional color of the dashboard item menu’s icons.
@dashboard-item-menu-remove-icon-color	The color of the dashboard item menu’s Delete icon.
@dashboard-item-menu-separator-color	The color of the dashboard item menu’s separator.
@dashboard-item-menu-item-border-color	The border color of a dashboard item. The border appears when you hover or select a dashboard item in the [Designer]> (xref:119283#designer-and-viewer-modes) mode.
@dashboard-item-binding-menu-bg	The background color of the dashboard item’s Binding menu.
@dashboard-item-binding-menu-filter-section-bg	The background color of the Binding menu’s Filter section.
@dashboard-menu-bg	The dashboard menu‘s background color.
@dashboard-menu-color	The dashboard menu’s basic color.
@dashboard-menu-header-bg	The background color of the dashboard menu’s header.
@dashboard-menu-header-color	The primary color of the dashboard menu’s header.
@dashboard-menu-icon-color	The color of the dashboard menu’s icons (for example, the X icon used to close the menu).
@dashboard-menu-selected-bg	The background color of the selected element in the dashboard’s menu.
@dashboard-menu-selected-color	The color of the selected dashboard menu’s element.
@dashboard-menu-hover-bg	The background color applied to elements in a dashboard menu when you hover over them.
@dashboard-menu-hover-color	The primary color applied to elements in a dashboard menu when you hover over them.
@dashboard-toolbar-color	The text color of the dashboard item caption and dashboard title.

Apply a Custom Theme

A custom theme’s icons should be in the same folder as the theme’s CSS files. The icons folder is located in the node_modules/devextreme/dist/css directory. Copy the icons folder to the directory that contains your custom theme.

To apply a custom theme, register the generated CSS files instead of the default styles.

Create the Content | custom-themes folder in the project and put the generated CSS files in the created folder. Then replace corresponding existing CSS files with the generated ones:

<!-- ... -->
<link href="Content/custom-themes/dx.light-yellow.min.css" rel="stylesheet" />
<link href="node_modules/@devexpress/analytics-core/dist/css/dx-analytics.common.css" rel="stylesheet" />
<link href="Content/custom-themes/dx-analytics.light-yellow.min.css" rel="stylesheet" />
<link href="node_modules/@devexpress/analytics-core/dist/css/dx-querybuilder.css" />
<link href="Content/custom-themes/dx-dashboard.light-yellow.min.css" rel="stylesheet" />

The image below shows the Web Dashboard with the custom Light Yellow theme: