Bar Charts (Quick Reference)
Bar charts present categorical data with rectangular bars with heights or lengths proportional to the values they represent.
Vertical
To place the columns vertically, set chart.type
to bar
:
Vertical bars are always easy to read on mobile devices. In case there are many categories, the end user will scroll vertically instead of horizontally.
Bar.groovy
ResultHighchart verticalBars(
String title,
List<String> categories,
List<Map<String, Object>> series
) {
return api.buildHighchart([
chart: [
type: 'bar', // ❶
],
credits: [
enabled: false, // Hide the Highcharts link
],
title: [
text: title,
],
xAxis: [
categories: categories,
],
yAxis: [
min: 0,
title: title
],
series: series
])
}
❶ Places the bars vertically.
BarChartVertical.groovy
def bar = libs.Library_Charts.Bar
String title = 'Sales per Quarter & Region'
def categories = [
'2019-Q1', '2019-Q2', '2019-Q3', '2019-Q4',
'2020-Q1', '2020-Q2', '2020-Q3', '2020-Q4',
]
def series = [[
name: 'EMEA',
data: [49.9, 71.5, 106.4, 129.2, 144.0, 176.0, 135.6, 148.5]
], [
name: 'APAC',
data: [83.6, 78.8, 98.5, 93.4, 106.0, 84.5, 105.0, 104.3]
]]
return bar.verticalBars(title, categories, series)
Horizontal
To place the columns horizontally, set chart.type
to column
. Horizontal bars are typically used to display time dependent data.
Horizontal bar charts can become difficult to read if there are many categories, especially on mobile devices. Consider using vertical bars instead.
Bar.groovy
ResultHighchart horizontalBars(
String title,
List<String> categories,
List<Map<String, Object>> series
) {
return api.buildHighchart([
chart: [
type: 'column', // ❶
],
credits: [
enabled: false, // Hide the Highcharts link
],
title: [
text: title,
],
xAxis: [
categories: categories,
],
yAxis: [
min: 0,
title: title
],
series: series
])
}
❶ Places the bars horizontally.
BarChartHorizontal.groovy
Found an issue in documentation? Write to us.