Version 5.6

[stockiNail]

5.6 is the last stable release.

Documentation: https://pepstock-org.github.io/Charba-Wiki.
API JavaDoc: https://pepstock-org.github.io/Charba/5.6.
Showcase GWT: https://pepstock-org.github.io/Charba-Showcase.
Showcase J2CL: https://pepstock-org.github.io/Charba-Showcase-J2CL.

Breaking changes

• DOM events refactoring.
  • rename org.pepstock.charba.client.enums.Event enumeration to org.pepstock.charba.client.enums.DefaultEvent.
  • remove org.pepstock.charba.client.dom.BaseNativeEvent class. Use org.pepstock.charba.client.dom.events.NativeBaseEvent or its subclasses in org.pepstock.charba.client.dom.events package instead.
  • remove org.pepstock.charba.client.dom.BaseEventTypes class. Use event types enumerations in in org.pepstock.charba.client.dom.enums package instead.
  • move Touch and TouchList classes from org.pepstock.charba.client.dom to org.pepstock.charba.client.dom.events one.
  • toast utility will use org.pepstock.charba.client.dom.events.NativeMouseEvent class for its actions.
• rename getDatasetElement method to getElement in AbstractDatasetContext class.
• rename DatasetElement class to ChartElement.
  • the chart elements are typed based on the data type of the chart controller.
• rename DatasetElementOptions class to ChartElementOptions.
  • the chart elements options are typed based on the data type of the chart controller.
• rename ChoroplethBar class to GeoFeatureElement
• remove ChoroplethElement class, accessible by the options elements node. Use chart.getOptions().getElements().getElement(GeoFeatureElementOptions.FACTORY) to get the GEO feature element options, by GeoFeatureElementOptions class.
• remove BubbleMapPoint class. Use Point element class instead to configure bubble map points.

Features

• import CHART.JS GEO controller version v3.9.0.
• import CHART.JS SANKEY controller version v0.9.1.
• import CHART.JS ANNOTATION plugin version v2.0.1.
• import CHART.JS GRADIENT plugin version v0.5.1.
• import LUXON datetime library version v3.0.3.
• DOM events refactoring.
  • enable custom event types to define to CHART.JS options by IsEvent interface, on top of the default ones.
  • create specific classes to map DOM events in org.pepstock.charba.client.dom.events package:
    • NativeBaseEvent to map the Event javascript class.
    • NativeUIEvent to map the UIEvent javascript class.
    • NativeMouseEvent to map the MouseEvent javascript class.
    • NativeTouchEvent to map the TouchEvent javascript class.
    • NativePointerEvent to map the PointerEvent javascript class.
    • NativeKeyboardEvent to map the KeyboardEvent javascript class.
    • NativeCustomEvent to map the CustomEvent javascript class.
  • enable events creation by own event initialization configuration.
• add base option to Bar element options and configuration class.
• add specific data element and own options based to dataElementType property of CHART.JS controller, in the DatasetReference, DatasetItem and AbstractDatasetContext classes.
  • ArcElement and ArcElementOptions classes for controllers which are using arcs to draw the chart.
  • BarElement and BarElementOptions classes for controllers which are using bars to draw the chart.
  • PointElement and PointElementOptions classes for controllers which are using points to draw the chart.
  • MatrixElement and MatrixElementOptions classes for matrix charts.
  • TreeMapElement and TreeMapElementOptions classes for treemap charts.
  • SankeyElement and SankeyElementOptions classes for sankey charts.
  • GeoFeatureElement and GeoFeatureElementOptions classes for GEO choropeth charts.
• add GeoFeatureElementOptions configuration element to BubbleMap chart.
• add register method to charts, where the controller type is not a CHART.JS out-of-the-box ones, in order to register then and act on the options if needed before instantiating a chart instance.
  • applied to matrix, sankey, treemap, choropleth, bubblemap, gauge and meter charts.
• add options element factories to matrix, sankey, treemap, choropleth and bubblemap charts in order to manage defaults options once for all chart instances in the application.
• enable Datalabels plugin use for matrix and treemap charts.

Development

• change dependency for Google Closure Compiler, version v20220905.

---

This discussion was created from the release Version 5.6.