Pie with Annotations

Annotations are containers for images, text blocks, and custom content. Annotations can help deliver a more refined user-experience and can improve analysis and readability (by displaying additional information for visualized data).

To create annotations, populate the PieChart's annotations array. Each object in the array configures an individual annotation. To specify settings for all annotations, use the commonAnnotationSettings object. Individual settings take precedence over common settings.

You can set each annotation type property to "text", "image", or "custom". In this demo, the type used for all annotations is "image".

Annotations can deliver more information if you add tooltips. A tooltip appears when users hover the mouse pointer over an annotation. This demo illustrates how you can implement a tooltip with custom content via the tooltipTemplate property.

For more information on annotation settings, refer to the annotations[] help topic.

See more Hide details

Prev Demo Next Demo

Was this demo helpful?

Thank you!

Feel free to share demo-related thoughts here.
If you have technical questions, please create a support ticket in the DevExpress Support Center.

Send Feedback

Thank you!
We appreciate your feedback.

jQuery

Angular

Vue

React

ASP.NET Core

ASP.NET MVC

Backend API

Copy to CodePen

Apply

Reset

$(() => { $('#pie').dxPieChart({ palette: 'Vintage', dataSource, commonAnnotationSettings: { type: 'image', image: { height: 60, width: 90, }, color: 'transparent', border: { color: 'transparent', }, paddingLeftRight: 0, paddingTopBottom: 0, tooltipTemplate, }, annotations: getAnnotationSources(), series: [{ argumentField: 'country', valueField: 'gold', label: { visible: true, position: 'inside', radialOffset: 83, backgroundColor: 'transparent', font: { size: 16, weight: 600, }, }, }], tooltip: { paddingLeftRight: 12, paddingTopBottom: 10, }, legend: { visible: false, }, title: 'Ice Hockey World Championship Gold Medal Winners', }); function getAnnotationSources() { annotations.forEach((a, index, array) => { array[index].image = `../../../../images/flags/3x2/${a.argument.replace(/\s/, '')}.svg`; array[index].data = $.extend({}, dataSource.filter((d) => d.country === a.argument)[0]); if (a.location === 'edge') { array[index] = $.extend({}, a, edgeAnnotationSettings); } }); return annotations; } function tooltipTemplate(annotation, container) { const { data } = annotation; const contentItems = ["<div class='medal-tooltip'>", "<div class='country-name'></div>", "<div class='gold'><span class='caption'>Gold</span>: </div>", "<div class='silver'><span class='caption'>Silver</span>: </div>", "<div class='bronze'><span class='caption'>Bronze</span>: </div>", '</div>']; const content = $(contentItems.join('')); content.find('.country-name').text(data.country); if (data.oldCountryName) { content.find('.country-name').append('<br/>').append(document.createTextNode(data.oldCountryName)); } content.find('.gold').append(document.createTextNode(data.gold)); content.find('.silver').append(document.createTextNode(data.silver)); content.find('.bronze').append(document.createTextNode(data.bronze)); content.appendTo(container); } });

<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0" /> <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script> <script>window.jQuery || document.write(decodeURIComponent('%3Cscript src="js/jquery.min.js"%3E%3C/script%3E'))</script> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/23.1.5/css/dx.light.css" /> <script src="https://cdn3.devexpress.com/jslib/23.1.5/js/dx.all.js"></script> <script src="data.js"></script> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="index.js"></script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="pie"></div> </div> </body> </html>

#pie { height: 440px; } .medal-tooltip { font-size: 12px; } .medal-tooltip .country-name { font-size: 14px; font-weight: 700; margin: 5px 0 10px 0; } .medal-tooltip .caption { font-weight: 600; }