12th June, Marco
Should I use SVG or canvas for the charts on my website?
9th June, Richard
New version of RGraph: version 7.20
3rd June, Patrick
Question about installing RGraph
1st June, Ouja
How do I add a click event to a bar in my Bar chart?
8th May, Anthony Kuma
Does the SVG Line chart have outofbounds functionality?
Using formatted labels
Introduction
Formatted labels are available to you as of version 6.0 of RGraph for both canvas and SVG charts and allow you to specify a single template string as the label which has certain macros in it and RGraph will replace those macros with the correct values.
Label templates are very similar to tooltip templates in their appearance albeit with fewer macros available to them (because only strings are permitted - not HTML).
Here's an example of a chart that uses label templates. In the download archive there's a demo called demos/activity-radial2.html which shows off label templates to good effect. It's not by any means a complicated demo - but it's effective.
Example
<script>
data = [28,19,39,45];
values = RGraph.clone(data);
labels = ['John','Fred','Mark','Andy'];
new RGraph.Activity({
id: 'cvs',
min: 0,
max: 100,
value: data,
options: {
marginInner: 2,
backgroundColor: 'transparent',
backgroundGrid: false,
backgroundGridRadials: false,
backgroundRings: false,
colors: ['red','blue','#aaa','black'],
labels: '%{global:labels[%{index}]} (%{value_formatted})',
labelsFormattedUnitsPost: '%',
labelsSize: 10,
labelsBold: true,
labelsItalic: true,
labelsColor: '#333',
labelsOffsetx: -20,
labelsFormattedUnitsPost:'%',
responsive: [
{maxWidth: null, css: {cssFloat: 'right'}},
{maxWidth: 600, css: {cssFloat: 'none'}}
]
}
}).draw();
</script>
What macros are available?
You can use these macros when you're creating your template label string. Note that because there's no concept of a group or sequential index there's only one index macro available.- xxxFormattedPoint [.]: This character is used as the decimal point.
- xxxFormattedThousand [,]: This character is used as the thousand separator.
- xxxFormattedDecimals [0]: This specifies the number of decimals that are shown.
- xxxFormattedUnitsPre [an empty string]: These units are prepended to the number.
- xxxFormattedUnitsPost [an empty string]: These units are appended to the number.