Dojo Charting: Legends

By on November 9, 2012 2:00 am


The Legend widget is one of the most popular features in Dojo charting. This widget was contributed by Chris Mitchell of IBM. It can handle all existing chart and plot types and supports horizontal and vertical modes.


By default it uses the “legend” parameter of a series. It reverts to the “name” parameter if legend is not specified.

For a pie chart, the behavior is different: if the chart was specified with an array of numbers, it will use numbers. Otherwise it will check object properties in the following order: “legend”, “text”, and the numeric value.


The legend icons will change if you have more than one series. This is especially evident in Marker charts:


Legends can be created programmatically as well. Just pass in the chart object instead of the chart id. The following code makes the Marker chart shown above:

], function(Chart, Legend, Markers, PlotKitGreen){

	var chart = new Chart("chartNode");
	chart.addPlot("default", {type: "Markers"});
	chart.addSeries("Series A", [2.6, 1.8, 2, 1, 1.4, 0.7, 2]);
	chart.addSeries("Series B", [5.6, 1, 9, 11, 4.4, 8.7, 2]);
	chart.addSeries("Series C", [8.6, 6, 3, 6, 8, 6, 6]);

	new Legend({chartRef:chart}, 'legendNode');

Further Reading


  • rajesh uppiliappan

    Hi Mike Wilcox,
    Im in need of exporting a dojo chart along with its legends. I have successfully converted the chart to svg and sent it to REST server and downloaded it as a pdf file. But I have problem in converting the legends to the SVG as they are mixed up with HTML elements. Please let me know if there is a way to convert the legends to svg.