Segmented donut chart

• Example
• Properties
• Methods
• Events
• Effects

Example

<script>
    segmented = new RGraph.Segmented({
        id: 'cvs',
        min: 0,
        max: 100,
        value: 67,
        options: {
            width: '-15',
            labelUnitsPost: '%',
            labelSize: 45
        }
    }).roundRobin({frames: 90});
    
    segmented.canvas.onclick = function (e)
    {
        var value = segmented.getValue(e);
        segmented.value = value;

        segmented.grow();
    }
</script>

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.

• Chart configuration properties
• Margin properties
• Color properties
• Labels and text properties
• Interactive features properties
• Miscellaneous properties

Chart configuration properties

Margin properties

Color properties

Labels and text properties

<div style="margin-left: 50px; display: inline-block">
    <canvas id="cvs" width="650" height="250"></canvas>
</div>

<div style="margin-left: 50px; display: inline-block">
    <canvas id="cvs" width="650" height="250"></canvas>
</div>

Interactive features properties

Miscellaneous properties

Methods

This method can be used to get the value at a particular point when you click on the chart (or for a specific angle that you give, measured in radians). An example:

obj.canvas.onclick = function (e)
{
    var obj   = e.target.__object__;
    var value = obj.getValue(e);
    // var value = obj.getValue(angle); // Provide an angle to the function instead of an event object
    
    // ...
}

obj.on(event, function)

This method can be used to set an event listener on an object. It operates similarly to the jQuery on function. The first argument is the event that you wish to attach to and the second is the handler function. For example:

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

The function is useful if you use method chaining when creating your charts:

var obj = new RGraph.Segmented({
    id: 'cvs',
    min: 0,
    max: 100,
    value: 56,
    options: {
    }
}).on('draw', function (e, shape)
{
    // Put the draw event code here
})
.on('draw', function (e, shape)
{
    // Handle the draw event with another function
}).draw();

The exec function is documented 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 show a smaller version of the chart.

The responsive function is documented on its own page here.

Events

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

• adjustbegin This event fires at the start of adjusting - like the standard mousedown event.
• adjust This event fires (repeatedly) during adjusting - like the standard mousemove event.
• adjustend This event fires at the end of adjusting - like the standard mouseup event.
• annotatebegin This event fires at the start of annotating - like the standard mousedown event.
• annotate This event fires (repeatedly) during annotating - like the standard mousemove event.
• annotateend This event fires at the end of annotating - like the standard mouseup event.
• annotateclear This event fires at the end of the RGraph.clearAnnotations function.
• beforeclear This event fires at the start of the RGraph.clear function.
• clear This event fires at the end of the RGraph.clear function.
• beforecontextmenu This event fires when you have the contextmenu enabled and it is about to appear.
• contextmenu This event fires when you have the contextmenu enabled and it has been displayed.
• beforedraw This event fires at the start of the draw method before anything has been done.
• firstdraw This event fires at the end of the draw function - but only the first time that the draw function is called.
• draw This event fires at the end of the draw function.

new RGraph.Segmented({
    id: 'cvs',
    min: 0,
    max: 100,
    valllue: 45,
    options: {
    }
}).on('draw', function (obj)
{
    console.log('The draw event has fired');
    
}).draw();

Effects

• The grow effect (effects-segmented-grow.html in the download archive)
• The roundRobin effect (effects-segmented-roundRobin.html in the download archive)

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

    segmented = new RGraph.Segmented({
        id: 'cvs',
        min: 0,
        max: 100,
        value: 56,
        options: {
            marginLeft: 35
        }
    }).roundRobin({frames: 60}, myCallback);
    
    setInterval(function ()
    {
        segmented.value = segmented.value + RGraph.random(-10,10);
        segmented.grow();
    }, 2500);
</script>