Bipolar chart

• Example
• The coordinates properties
• Properties
• Methods
• Data properties that are used on the bars
• Events
• Effects

Example

<script>
    labels = ['Monday','Tuesday','Wednesday'];

    bipolar = new RGraph.SVG.Bipolar({
        id: 'chart-container',
        left: [[8,5],[6,3],[4,8]],
        right: [[1,2],[8,2],[6,5]],
        //left: [4,8,6],
        //right: [4,8,5],
        options: {
            backgroundGridHlines: false,
            backgroundGridBorder: false,
            title: 'A Bipolar chart',
            titleSubtitle: 'A subtitle for the chart that was generated on Sunday',
            titleSubtitleItalic: true,
            marginTop: 50,
            colors: ['red','black'],
            yaxisLabels: '%{global:labels[%{index}]}',
            yaxisTextBold: true,
            yaxisTextItalic: true,
            xaxis: false,
            yaxisColor: '#aaa',
            shadow: true,
            tooltips: 'Results:%{key}',
            tooltipsFormattedUnitsPre: '$',
            tooltipsFormattedUnitsPost: '',
            tooltipsFormattedDecimals: 2,
            tooltipsFormattedKeyLabels: ['Berty','Charles'],
            tooltipsCss: {
                backgroundColor: '#333',
                fontWeight: 'bold',
                fontSize: '14pt',
                opacity: 0.85,
                responsive: [
                    {maxWidth: 700, width: 400, height: 200,options: {textSize: 8, marginInner: 4}},
                    {maxWidth: 950, width: 600, height: 250,options: {textSize: 12, marginInner: 3}},
                    {maxWidth: null, width: 700, height: 350,options: {textSize: 16, marginInner: 5}}
                ]
            }
        }
    }).draw();
</script>

The coordinates properties

The coordinates for the bars on the Bipolar chart are held in the following arrays:

• obj.coords
  All of the coordinates - that are simply appended to this array as the bars are drawn. Each element of the array is an object which consists of x, y, width, height, element and object properties. The element property is the svg rect element and the object property is the RGraph object.
  
  
• obj.coordsLeft
  Similar to the obj.coords array but just for the left-hand-side bars.
  
  
• obj.coordsRight
  Similar to the obj.coords array but just for the right-hand-side bars.
  
  
• obj.coords2
  Again, this is all of the coordinates - but arranged slightly differently. This is only used by stacked and grouped Bipolar charts - each element is an array of that groups/stacks segments. then each sub-element is an object which consists of x, y, width and height, element and object properties. The element property is the svg rect element and the object property is the RGraph object.
  
  
• obj.coords2Left
  Similar to the obj.coords2 array but just for the left-hand-side bars.
  
  
• obj.coords2Right
  Similar to the obj.coords2 array but just for the right-hand-side bars.
  
  

Properties

You can use these properties to control how the chart appears. You can set them by including them in the options section of the configuration as shown above.

• Background properties
• Margin properties
• Color properties
• X-axis properties
• Y-axis properties
• Other label properties
• Key properties
• Tooltip properties
• Shadow properties
• Title properties
• Other properties

Background properties

Margin properties

Color properties

X-axis properties

Y-axis properties

Other label properties

Key properties

Tooltip properties

tooltipsOverride: function (obj, opt)
{
    // Show tooltip
}

tooltipsFormattedKeyColorsCss : {
    border: "1px solid #ddd";
}

tooltipsFormattedListItems: [
    ['Bill','Jerry','Berty'], // First tooltip
    ['Gill','Carrie','Lucy'], // Second tooltip
    ['Pob','Nobby','Hilda']   // Third tooltip
]

.RGraph_tooltip ul#rgraph_formatted_tooltips_list li {
    text-align: left;
    color: yellow;
}

tooltips: {
    borderLeft: 'gray 2px solid',
    borderBottom: 'gray 2px solid'
}

tooltipsCss: {
    fontFamily: 'Verdana',
    fontSize: '20pt'
}

tooltipsOverride: function (obj, opt)
{
    // Show tooltip
}

tooltipsFormattedKeyColorsCss : {
    border: "1px solid #ddd";
}

tooltipsFormattedListItems: [
    ['Bill','Jerry','Berty'], // First tooltip
    ['Gill','Carrie','Lucy'], // Second tooltip
    ['Pob','Nobby','Hilda']   // Third tooltip
]

.RGraph_tooltip ul#rgraph_formatted_tooltips_list li {
    text-align: left;
    color: yellow;
}

tooltips: {
    borderLeft: 'gray 2px solid',
    borderBottom: 'gray 2px solid'
}

tooltipsCss: {
    fontFamily: 'Verdana',
    fontSize: '20pt'
}

Shadow properties

Title properties

Other properties

Methods

This can be used to get properties if necessary. It's normally used after the chart is drawn if you need to get parameters (if you're doing custom coding for example).

This can be used to set properties if necessary. It's normally used after the chart is drawn if you need to set additional parameters or change them.

This returns the width that represents the given value. It does not give you a start or end point - just the width.

This returns the left-hand-side x-axis coordinate for a given value. The left x-axis coordinate can be retrieved by doing this:

<script>
    x0 = obj.get('marginLeft') + obj.graphWidth;
</script>

This returns the right-hand-side x-axis coordinate for a given value. The right x-axis coordinate can be retrieved by doing this:

<script>
    x0 = obj.get('marginLeft') + obj.graphWidth + obj.get('marginCenter');
</script>

This function adds an event listener (such as beforedraw or draw) to the chart object. For example:

obj.on('draw', function (obj)
{
    // Put your code here
});

This function can be used to execute a function (immediately). It's not event-based (ie it doesn't run when something happens) - it just runs immediately - and only once. You might use it when you need to get something from the chart when it's drawn and then call the redraw function. Because this function only runs once the RGraph.SVG.redraw function would not cause a loop - which would happen if you used the draw event.

obj.exec(function (obj)
{
    // Put your code here
});

The responsive function helps your charts respond to different browser window sizes and screen resolutions. For example, for smaller screens, you might want to have angled labels or show shorter versions of them completely.

Update: There is now the responsive configuration option available to you and this is now the preferred method of configuration.

The responsive function and configuration option are documented on their own page here.

Data properties that are used on the bars

The svg rect elements that represent the bars on the Bipolar chart have various data attributes added to them that hold various bits of information. These are:

• data-original-x
• data-original-y
• data-original-width
• data-original-height
• data-index
• data-subindex (only used in grouped or stacked charts)
• data-sequential-index
• data-value
• data-tooltip

These can be retrieved by using standard dom methods:

obj.coords[0].element.getAttribute('data-sequential-index');

Events

RGraph supports custom events that allow you to easily add interactivity to your charts if required. The following events are available:

• beforedraw This event fires at the start of the draw method before anything has been done.
• draw This event fires at the end of the draw function.
• firstdraw This event fires at the end of the draw function - but only the first time and so it fires only once after the first draw call.
• beforetooltip This event fires at the start of the tooltip showing process.
• tooltip This event fires after a tooltip has been shown.

new RGraph.SVG.Bipolar({
    id: 'chart-container',
    left: [4,8,6,4,5,2,3],
    right: [8,4,6,3,5,8,4],
    options: {
    }
}).on('draw', function (obj)
{
    console.log('The draw event has fired');
    
}).draw();

Effects

• The grow effect (svg-bipolar-effect-grow.html in the download archive)
• The wave effect (svg-bipolar-effect-wave.html in the download archive)

<script>
    //
    // Optional callback function that's called when the effect is complete
    //
    function myCallback (obj)
    {
        // ...
    }

    obj = new RGraph.SVG.Bipolar({
        id: 'chart-container',
        left:  [4,8,6,3,6,9,8],
        right: [4,5,3,5,6,1,2],
        options: {
        }
    }).grow({frames: 60, callback: myCallback});
</script>