Charts 9 comes with new chart types and brings back the API to style from Java.
If you are migrating your project to platform V17, there might be different approaches related with which styling option you will pick.
Both CSS and Java styling cannot be used in the same projectWhile no error is thrown if different styling methods are used in the same project, only one method should be used across all charts, since having both could lead to unexpected results.
Since V17 uses Java API for styling by default, there’s no needed to do any extra step.
|There might be small changes for APIs that no longer work between the Highcharts versions used for V8 and V17.|
If you want to convert your project to use CSS styling, there are a few steps needed to make it work:
Enable CSS style by setting
Chart chart = new Chart(); Configuration conf = chart.getConfiguration(); conf.getChart().setStyledMode(true);
Import the charts default theme module to your view with:
For more detailed instructions, please check the "CSS Styling guide"
If your project does not have any Charts custom theme, then there’s no extra step needed to do.
In the other hand, if it has custom themes, then they should be
removed, along aside their
@CssImport annotations. You can, then, use the Java
API for styling the charts.
While Charts 9 is released for V17, a project running V14 in npm mode could use the new Charts by overriding the version at the project’s POM file:
<dependency> <groupId>com.vaadin</groupId> <artifactId>vaadin-charts-flow</artifactId> <version>9.0.0</version> </dependency>
|Check the latest version on the Charts release page.|
Then, to start using it, check the From a V10+ project instructions presented on this page.