About
RGraph is a JavaScript charts library based on HTML5 SVG and canvas. RGraph is mature (over 15 years old) and has a wealth of features making it an ideal choice to show charts on your website.

More »

 

License
RGraph can be used for free under the GPL or if that doesn't suit your situation there's an inexpensive (£99) commercial license available.

More »

 

Download
Get the latest version of RGraph (version 6.16) from the download page. There's also older versions available, minified files and links to cdnjs.com hosted libraries.

More »

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.