Using HTML keys

Summary: RGraph can generate HTML (ie DIV/TABLE/SPAN) keys instead of drawing them on the canvas. In some cases these can be easier to interact with and they don't need to be redrawn.

• Introduction
• An example
• Configuration options
• Adding a link to the key
• The return value
• Getting all of the label SPAN tags

Introduction

The new (December 2013) HTML and JavaScript based key gives you a way to have a key that's generated outside of the canvas and that's a part of the page just like your other HTML. The key is made up of a TABLE tag - which contains the list of key entries.

Because the key is not drawn onto the canvas it's not subject to redraws (see important note though) and you can script interactivity with it quite easily, such as add event handlers.

The list of configuration options is below.

Important note: Because the rendering of the key involves setting the innerHTML property of the container that means that any canvas tag that's inside will be reset. So, like it is here, you may need to draw the key before you draw the chart.

An example

Remember!
This is JavaScript and NOT CSS - meaning that strings (eg CSS property names and values) need to be surrounded by single or double quotes.

<script>
    key = RGraph.HTML.Key(
        'container',
        {
            colors: ['red','#0f0', 'blue','orange'],
            labels:[
                'Louise',
                'Fred<br /><span style="font-size:70%">Warning!</span>',
                'Charley',
                'Lucy'
            ],
            links: [
                'http://www.google.com#q=louise',
                "javascript: window.open('http://www.google.com#q=fred');" +
                "event.stopPropagation()"
            ],
            tableCss:{
                position:'absolute',
                top:'25px',
                left:'590px'
            },
            tableClass: 'rgraph_key',
            blobCss: {
                'border-radius': '0'
            },
            blobClass: 'rgraph_key_blob',
            labelCss: {
            },
            labelClass: 'rgraph_key_label',

                
            labelCss_0: {
                color: 'red',
                'font-weight': 'bold'
            },
            
            labelCss_1: {
                color: '#00f',
                'font-weight': '900'
            },
        }
    );
</script>

Configuration options

Required options

Other options

Adding links to the key

Adding a link to the key so that it can be clicked to get (eg) more information or to trigger something on the chart is easy as the links option is provided. Normally this is a URL that opens in the same window as the current page. You can change this behaviour by using the window.open JavaScript function as the example above shows.

The return value

The return value from the function is a DIV object (like you get back from document.getElementById() ). You can then manipulate it as you would any other DOM node.

Getting all of the label SPAN tags

You can get hold of the SPAN tags that hold the labels by, again, using the DOM methods:

// The key variable is what the RGraph.HTML.Key()
function returns
span_tags = key.getElementsByTagName('SPAN');
name = span_tags[0].innerHTML;