Bar Chart in TypeScript Charts
18 Nov 20182 minutes to read
Bar
To render a bar series in your chart, you need to follow a few steps to configure it correctly. Here’s a concise guide on how to do this:
-
Set the series type: Define the series
typeasBarin your chart configuration. This indicates that the data should be represented as a bar chart, which makes it easy to compare values across categories.
Binding data with series
You can bind data to the chart using the dataSource property within the series configuration. This allows you to connect a JSON dataset or remote data to your chart. To display the data correctly, map the fields from the data to the chart series xName and yName properties.
Series customization
The following properties can be used to customize the bar series.
Fill
The fill property determines the color applied to the series.
The fill property can be used to apply a gradient color to the bar series. By configuring this property with gradient values, you can create a visually appealing effect in which the color transitions smoothly from one shade to another.
Opacity
The opacity property controls the transparency of the fill and affects how the series blends with background or overlapping series.
Border
Use the border property to configure the border width, color, and dasharray of the bar series.
Bar space and width
Bar space
Use the columnSpacing property in the series to adjust the space between bars.
Bar width
Use the columnWidth property in the series to adjust the width of the bars.
Bar width in pixel
Use the columnWidthInPixel property in the series to define the exact width of the bars in pixels. This property ensures that each bar maintains the specified width, providing a uniform appearance throughout the chart.
Grouped bar
Use the groupName property to group the data points in bar type charts. Data points with the same group name will be grouped together in the chart, making it easy to compare different sets of data.
Cylindrical bar chart
To render a cylindrical bar chart, set the columnFacet property to Cylinder in the chart series. This property transforms the regular bars into cylindrical shapes, enhancing the visual representation of the data.
Empty points
Data points with null or undefined values are considered empty. Empty data points are ignored and not plotted on the chart.
Mode
Use the mode property to control handling of empty points. Available modes: Gap, Drop, Zero, Average. The default mode is Gap.
Fill
Use the fill property to set the fill color for empty points.
Border
Use the border property to customize the border width and color for empty points.
Corner radius
The cornerRadius property in the chart series is used to customize the corner radius for bar series. This allows you to create bars with rounded corners, giving your chart a more polished appearance. You can customize each corner of the bars using the topLeft, topRight, bottomLeft, and bottomRight properties.
Point corner radius
You can customize the corner radius for individual points in the chart series using the pointRender event by setting the cornerRadius property in its event argument.
Events
Series render
The seriesRender event enables modification of series properties (for example, data, fill, or name) immediately before rendering. Use this event to adjust series appearance or to dynamically swap data sources.
Point render
The pointRender event provides a hook to customize each data point (for example, marker shape, border, or fill) before it is drawn. Use this to apply per-point styling rules or conditional formatting.