Skip to main content

Themes

webforJ includes three built-in app themes and supports defining your own custom themes. The default themes are:

  • light: A bright theme with a light background (default).
  • dark: A dark background tinted with the primary color.
  • dark-pure: A fully neutral dark theme based on gray tones.

To apply a theme in your app, use the @AppTheme annotation or the App.setTheme() method. The theme name must be one of: system, light, dark, dark-pure, or a custom theme name.

@AppTheme("dark-pure")
class MyApp extends App {
  // app code
}

// or programmatically
App.setTheme("dark-pure");

Overriding default themes​

You can override the light theme by redefining CSS custom properties in the :root selector.

:root pseudo-class

The :root CSS pseudo-class targets the root element of the document. In HTML, it represents the <html> element and has higher specificity than the plain html selector.

Example:

:root {
  --dwc-color-primary-h: 215;
  --dwc-color-primary-s: 100%;
  --dwc-color-primary-c: 50;
  --dwc-font-size: var(--dwc-font-size-m);
}

To override the dark or dark-pure themes, use attribute selectors on the <html> element:

html[data-app-theme="dark"] {
  --dwc-color-primary-s: 9%;
  --dwc-color-white: hsl(210, 17%, 82%);
}

Creating custom themes​

You can define your own themes using the html[data-app-theme='THEME_NAME'] selector. Custom themes can coexist with the default ones, and you can switch between them dynamically at runtime.

html[data-app-theme="new-theme"] {
  --dwc-color-primary-h: 280;
  --dwc-color-primary-s: 100%;
  --dwc-color-primary-c: 60;
}

Then in your app:

@AppTheme("new-theme")
class MyApp extends App {
  // app code
}

// or programmatically
App.setTheme("new-theme");

Component themes​

In addition to app-level themes, webforJ components support a set of component themes based on the default color palettes: default, primary, success, warning, danger, info, and gray.

Each component documents its supported themes under the Styling → Themes section.