Themes & Styles
This help topic describes how to add SurveyJS UI themes to your Angular, Vue, React, Knockout, or jQuery application, switch between them, or create a custom theme for your survey.
Add SurveyJS Themes to Your Application
SurveyJS Form Library is shipped with several predefined UI themes. You can see what they look like and switch between them in Form Library demos.
To use a theme, you need to reference a SurveyJS style sheet. Refer to the following sections of Get Started help topics for detailed instructions:
- Configure Styles in Angular
- Configure Styles in Vue
- Configure Styles in React
- Link SurveyJS Resources in Knockout
- Link SurveyJS Resources in jQuery
Apply a Predefined Theme
Predefined themes are distributed as JSON objects that specify CSS variables and other theme settings. You can find a full list of predefined themes and their variations on GitHub: survey-core/themes. To apply a predefined theme, import its module or reference its script after survey-core. The following code shows how to apply the Layered Dark Panelless theme by importing a module:
import { Model } from "survey-core";
import "survey-core/themes/layered-dark-panelless";
The code below applies the same theme by referencing a script:
<head>
<!-- ... -->
<script type="text/javascript" src="https://unpkg.com/survey-core/survey.core.min.js"></script>
<script type="text/javascript" src="https://unpkg.com/survey-core/layered-dark-panelless.min.js"></script>
<!-- ... -->
</head>
If you want to add more than one theme, refer to the Switch Between Themes section for more information.
Create a Custom Theme
SurveyJS themes use CSS variables to specify colors, fonts, sizes, and other survey appearance settings. To create a custom theme, you need to change these variables. You can do this in Theme Editor—a UI theme designer with a user-friendly interface.
Theme Editor is integrated into Survey Creator. Open our all-in-one demo, switch to the Themes tab, and change theme settings using UI controls. Once you finish customization, click the Export button to download a JSON object with CSS variables and other theme settings:
To apply your custom theme, pass the downloaded JSON object to SurveyModel's applyTheme() method:
import { Model } from "survey-core";
const surveyJson = { ... };
const survey = new Model(surveyJson);
survey.applyTheme({
"cssVariables": {
// ...
},
"themeName": "double",
"colorPalette": "dark",
"isPanelless": true
});
Switch Between Themes
If you want to add more than one SurveyJS theme to your application, import them using named imports and call SurveyModel's applyTheme() method to specify an active theme. For example, the following code imports the Contrast Dark and Contrast Light themes and applies the latter:
import { Model } from "survey-core";
import { ContrastLight } from "survey-core/themes/contrast-light";
import { ContrastDark } from "survey-core/themes/contrast-dark";
const surveyJson = { ... };
const survey = new Model(surveyJson);
survey.applyTheme(ContrastLight)
Apply Custom CSS Classes
You can apply individual custom CSS classes to all survey elements of a specific type. To do this, define a JavaScript object in which keys specify survey elements and values specify CSS classes. For information on the object structure, refer to the following file on GitHub: defaultV2Css.ts. Assign this object to SurveyModel's css property.
In addition, the SurveyModel object raises events that allow you to override CSS classes for individual questions, panels, pages, and choice items. Refer to the following event descriptions in the API reference for more information:
Switch Between Themes (Obsolete Approach)
If your application contains more than one obsolete SurveyJS theme (Default, Modern, Default V2), call StylesManager's applyTheme(themeName) method to specify an active theme. Pass one of the following theme names as the method's argument:
"defaultV2""modern""default""orange""darkblue""darkrose""stone""winter""winterstone"
The code example below shows how to apply the Default V2 theme:
import { StylesManager } from 'survey-core';
StylesManager.applyTheme("defaultV2");
Bootstrap Support (Obsolete)
SurveyJS includes themes designed for use with Bootstrap and Bootstrap Material. However, they are obsolete and no longer receive updates.
Previously, Bootstrap integrations were part of the main package. Since v1.9.69, they are shipped as separate modules/scripts. The following code shows how to apply the Bootstrap or Bootstrap Material theme by importing a module:
// Apply the Bootstrap theme
import { bootstrapThemeName } from "survey-core/plugins/bootstrap-integration";
import { StylesManager } from 'survey-core';
StylesManager.applyTheme(bootstrapThemeName);
// Apply the Bootstrap Material theme
import { bootstrapMaterialThemeName } from "survey-core/plugins/bootstrap-material-integration";
import { StylesManager } from 'survey-core';
StylesManager.applyTheme(bootstrapMaterialThemeName);
The code below shows how to apply the themes by referencing a script:
<!-- Apply the Bootstrap theme -->
<script src="https://unpkg.com/survey-core/plugins/bootstrap-integration.min.js"></script>
Survey.StylesManager.applyTheme("bootstrap");
<!-- Apply the Bootstrap Material theme -->
<script src="https://unpkg.com/survey-core/plugins/bootstrap-material-integration.min.js"></script>
Survey.StylesManager.applyTheme("bootstrapmaterial");
Bootstrap theme customization in code has also changed. Objects that specify applied CSS classes have been moved to the integration modules/scripts mentioned above.
Previously:
// Assign another CSS class in Bootstrap (obsolete approach)
Survey.defaultBootstrapCss.page.description = "sv_page_description";
// In modular applications
import { defaultBootstrapCss } from "survey-core";
defaultBootstrapCss.page.description = "sv_page_description";
// Assign another CSS class in Bootstrap Material (obsolete approach)
Survey.defaultBootstrapMaterialCss.page.description = "sv_page_description";
// In modular applications
import { defaultBootstrapMaterialCss } from "survey-core";
defaultBootstrapMaterialCss.page.description = "sv_page_description";
Since v1.9.69:
// Assign another CSS class in Bootstrap (relevant approach)
SurveyBootstrap.defaultCss.page.description = "sv_page_description";
// In modular applications
import { defaultCss } from "survey-core/plugins/bootstrap-integration";
defaultCss.page.description = "sv_page_description";
// Assign another CSS class in Bootstrap Material (relevant approach)
SurveyBootstrapMaterial.defaultCss.page.description = "sv_page_description";
// In modular applications
import { defaultCss } from "survey-core/plugins/bootstrap-material-integration";
defaultCss.page.description = "sv_page_description";