Beta
effectSelection of Theme effect.
Either none (undefined
) or a GlowEffect
.
For performance reasons only 1 configuration of a glow effect is allowed within an application at the moment. This property has been marked as to stay reactive to changes in user needs. If users will need a better way to configure the drawing effects, then it can be refactored without a major release.
Convenience flag for controlling whether theme effect should be shown in dashboard splitters by default.
false
-> Dashboard splitters will have disabled theme effect by default.
Convenience flag for controlling whether theme effect should be shown in different Text components by default.
false
-> Text components will have disabled theme effect by default.
Optional
Readonly
examplesProperties of Theme that are optional, and officially only used in LightningChart JS Online Examples and projects.
These are guaranteed to be included in all official Library Themes provided by LightningChart, but not required in custom Themes defined by users.
If you want to use example theme properties in your application, then make sure to do these two things:
Theme.examples
property is undefined
, like this: // Example, ensure official LightningChart JS theme is in use.
const theme = chart.getTheme()
if (!theme.examples) {
throw new Error(`LightningChart JS Theme.examples is undefined. You are probably using an unofficial theme and attempting to access example theme properties!`)
}
Beta
highlightColor offset for chart components when highlighted.
// Example, highlighted components shift towards red.
highlightColorOffset: ColorRGBA(100, -50, -50, 0)
// Example, highlighted components are darkened.
highlightColorOffset: ColorRGBA(-100, -100, -100, 0)
This property is marked as meaning that it can be changed in minor version releases for the time being.
Optional
Beta
highlightOverride of highlightColorOffset for axis overlays (mouse interaction areas).
This property is marked as meaning that it can be changed in minor version releases for the time being.
Flag if Theme is dark or not.
For user defined themes, it doesn't have large consequences. However, incorrect use can have a slight negative effect on text sharpness.
For a Theme with dominantly dark backgrounds, should set the value to false
.
Interface for all properties of a library color theme.
A collection of default implementations can be accessed by Themes.
Color theme of components must be specified when it is created, and can't be changed afterwards (without destroying and recreating the component).
All charts within a Dashboard must always have the same theme. Thus, it is configured only when the Dashboard is created.
For custom color themes, refer to FAQ in API documentation and read section "How to use Custom Color Themes?".