Building a Donut Chart with Vue and SVG

Mmm… forbidden donut.”

– Homer Simpson

I recently needed to make a donut chart for a reporting dashboard at work. The mock-up that I got looked something like this:

My chart had a few basic requirements. It needed to:

  • Dynamically calculate its segments based on an arbitrary set of values
  • Have labels
  • Scale well across all screen sizes and devices
  • Be cross-browser compatible back to Internet Explorer 11
  • Be accessible
  • Be reusable across my work’s Vue.js front end

I also wanted something that I could animate later if I needed to. All of this sounded like a job for SVG.

SVGs are accessible out-of-the-box (the W3C has a whole section on this) and can be made more accessible through additional input. And, because they’re powered by data, they’re a perfect candidate for dynamic visualization.

There are plenty of articles on the topic, including two by Chris (here and here ) and a super recent one by Burke Holland. I didn’t use D3 for this project because the application didn’t need the overhead of that library.

I created the chart as a Vue component for my project, but you could just as easily do this with vanilla JavaScript, HTML, and CSS.

Here’s the finished product:

See the Pen Vue Donut Chart – Final Version by Salomone Baquis (@soluhmin ) on CodePen .

Reinventing the wheel circle

Like any self-respecting developer, the first thing I did was Google to see if someone else had already made this. Then, like same said developer, I scrapped the pre-built solution in favor of my own.

The top hit for “SVG donut chart” is this article , which describes how to use stroke-dasharray and stroke-dashoffset to draw multiple overlaid circles and create the illusion of a single segmented circle (more on this shortly).

I really like the overlay concept, but found recalculating both stroke-dasharray and stroke-dashoffset values confusing. Why not set one fixed stroke-dasharrary value and then rotate each circle with a transform? I also needed to add labels to each segment, which wasn’t covered in the tutorial.

Drawing a line

Before we can create a dynamic donut chart, we first need to understand how SVG line drawing works. If you haven’t read Jake Archibald’s excellent Animated Line Drawing in SVG . Chris also has a good overview .

Those articles provide most of the context you’ll need, but briefly, SVG has two presentation attributes : stroke-dasharray and stroke-dashoffset.

stroke-dasharray defines an array of dashes and gaps used to paint the outline of a shape. It can take zero, one, or two values. The first value defines the dash length; the second defines the gap length.

stroke-dashoffset , on the other hand, defines where the set of dashes and gaps begins. If the stroke-dasharray and the stroke-dashoffset values are the length of the line and equal, the entire line is visible because we’re telling the offset (where the dash-array starts) to begin at the end of the line. If the stroke-dasharray is the length of the line, but the stroke-dashoffset is 0, then the line is invisible because we’re offsetting the rendered part of the dash by its entire length.

Chris’ example demonstrates this nicely:

See the Pen Basic Example of SVG Line Drawing, Backward and Forward by Chris Coyier (@chriscoyier ) on CodePen .

How we’ll build the chart

To create the donut chart’s segments, we’ll make a separate circle for each one, overlay the circles on top of one another, then use stroke, stroke-dasharray, and stroke-dashoffset to show only part of the stroke of each circle. We’ll then rotate each visible part into the correct position, creating the illusion of a single shape. As we do this, we’ll also calculate the coordinates for the text labels.

Here’s an example demonstrating these rotations and overlays:

See the Pen Circle Overlays by Salomone Baquis (@soluhmin ) on CodePen .

Basic setup

Let’s start by setting up our structure. I’m using x-template for demo purposes, but I’d recommend creating a single file component for production.

Vue.component('donutChart', {
  template: '#donutTemplate',
  props: ["initialValues"],
  data() {
    return {
      chartData: [],
      colors: ["#6495ED", "goldenrod", "#cd5c5c", "thistle", "lightgray"],
      cx: 80,
      cy: 80,                      
      radius: 60,
      sortedValues: [],
      strokeWidth: 30,    
new Vue({
  el: "#app",
  data() {
    return {
      values: [230, 308, 520, 130, 200]

With this, we:

  • Create our Vue instance and our donut chart component, then tell our donut component to expect some values (our dataset) as props
  • Establish our basic SVG shapes: for the segments and for the labels, with the basic dimensions, stroke width, and colors defined
  • Wrap these shapes in a element, which groups them together
  • Add a v-for loop to the g> element, which we’ll use to iterate through each value that the component receives
  • Create an empty sortedValues array, which we’ll use to hold a sorted version of our data
  • Create an empty chartData array, which will contain our main positioning data

Circle length

Our stroke-dasharray should be the length of the entire circle, giving us an easy baseline number which we can use to calculate each stroke-dashoffset value. Recall that the length of a circle is its circumference and the formula for circumference is 2πr (you remember this, right?).

We can make this a computed property in our component.

computed: {
  circumference() {
    return 2 * Math.PI * this.radius

…and bind the value to our template markup.


In the initial mockup, we saw that the segments went from largest to smallest. We can make another computed property to sort these. We’ll store the sorted version inside the sortedValues array.

sortInitialValues() {
  return this.sortedValues = this.initialValues.sort((a,b) => b-a)

Finally, in order for these sorted values to be available to Vue before the chart gets rendered, we’ll want to reference this computed property from the mounted() lifecycle hook.

mounted() {

Right now, our chart look like this:

See the Pen Donut Chart – No Segments by Salomone Baquis (@soluhmin ) on CodePen .

No segments. Just a solid-colored donut. Like HTML, SVG elements are rendered in the order that they appear in the markup. The color that appears is the stroke color of the last circle in the SVG. Because we haven’t added any stroke-dashoffset values yet, each circle’s stroke goes all the way around. Let’s fix this by creating segments.

Creating segments

To get each of the circle segments, we’ll need to:

  1. Calculate the percentage of each data value from the total data values that we pass in
  2. Multiply this percentage by the circumference to get the length of the visible stroke
  3. Subtract this length from the circumference to get the stroke-offset

It sounds more complicated than it is. Let’s start with some helper functions. We first need to total up our data values. We can use a computed property to do this.

dataTotal() {
  return this.sortedValues.reduce((acc, val) => acc + val)

To calculate the percentage of each data value, we’ll need to pass in values from the v-for loop that we created earlier, which means that we’ll need to add a method.

methods: {
  dataPercentage(dataVal) {
    return dataVal / this.dataTotal

We now have enough information to calculate our stroke-offset values, which will establish our circle segments.

Again, we want to: (a) multiply our data percentage by the circle circumference to get the length of the visible stroke, and (b) subtract this length from the circumference to get the stroke-offset.

Here’s the method to get our stroke-offsets:

calculateStrokeDashOffset(dataVal, circumference) {
  const strokeDiff = this.dataPercentage(dataVal) * circumference
  return circumference - strokeDiff

…which we bind to our circle in the HTML with:

:stroke-dashoffset="calculateStrokeDashOffset(value, circumference)"

And voilà! We should have something like this:

See the Pen Donut Chart – No Rotations by Salomone Baquis (@soluhmin ) on CodePen .

Rotating segments

Now the fun part. All of segments begin at 3 o’clock, which is the default starting point for SVG circles. To get them in the right place, we need to rotate each segment to its correct position.

We can do this by finding each segment’s ratio out of 360 degrees and then offset that amount by the total degrees that came before it.

First, let’s add a data property to keep track of the offset:

angleOffset: -90,

Then our calculation (this is a computed property):

calculateChartData() {
  this.sortedValues.forEach((dataVal, index) => {
    const data = {
      degrees: this.angleOffset,
    this.angleOffset = this.dataPercentage(dataVal) * 360 + this.angleOffset

Each loop creates a new object with a “degrees” property, pushes that into our chartValues array that we created earlier, and then updates the angleOffset for the next loop.

But wait, what’s up with the -90 value?

Well, looking back at our original mockup, the first segment is shown at the 12 o’clock position, or -90 degrees from the starting point. By setting our angleOffset at -90, we ensure that our largest donut segment starts from the top.

To rotate these segments in the HTML, we’ll use the transform presentation attribute with the rotate function. Let’s create another computed property so that we can return a nice, formatted string.

returnCircleTransformValue(index) {
  return rotate(${this.chartData[index].degrees}, ${}, ${})`

The rotate function takes three arguments: an angle of rotation and x and y coordinates around which the angle rotates. If we don’t supply cx and cy coordinates, then our segments will rotate around the entire SVG coordinate system.

Next, we bind this to our circle markup.


And, since we need to do all of these calculations before the chart is rendered, we’ll add our calculateChartData computed property in the mounted hook:

mounted() {

Finally, if we want that sweet, sweet gap between each segment, we can subtract two from the circumference and use this as our new stroke-dasharray.

adjustedCircumference() {
  return this.circumference - 2

Segments, baby!

See the Pen Donut Chart – Segments Only by Salomone Baquis (@soluhmin ) on CodePen .


We have our segments, but now we need to create labels. This means that we need to place our elements with x and y coordinates at different points along the circle. You might suspect that this requires math. Sadly, you are correct.

Fortunately, this isn’t the kind of math where we need to apply Real Concepts; this is more the kind where we Google formulas and don’t ask too many questions.

According to the Internet , the formulas to calculate x and y points along a circle are:

x = r cos(t) + a
y = r sin(t) + b

…where r is the radius, t is the angle, and a and b are the x and y center point offsets.

We already have most of this: we know our radius, we know how to calculate our segment angles, and we know our center offset values (cx and cy).

There’s one catch, though: in those formulas, t is in *radians*. We’re working in degrees, which means that we need to do some conversions. Again, a quick search turns up a formula:

radians = degrees * (π / 180)

…which we can represent in a method:

degreesToRadians(angle) {
  return angle * (Math.PI / 180)

We now have enough information to calculate our x and y text coordinates:

calculateTextCoords(dataVal, angleOffset) {
  const angle = (this.dataPercentage(dataVal) * 360) / 2 + angleOffset
  const radians = this.degreesToRadians(angle)

  const textCoords = {
    x: (this.radius * Math.cos(radians) +,
    y: (this.radius * Math.sin(radians) +
  return textCoords

First, we calculate the angle of our segment by multiplying the ratio of our data value by 360; however, we actually want half of this because our text labels are in the middle of the segment rather than the end. We need to add the angle offset like we did when we created the segments.

Our calculateTextCoords method can now be used in the calculateChartData computed property:

calculateChartData() {
  this.sortedValues.forEach((dataVal, index) => {
    const { x, y } = this.calculateTextCoords(dataVal, this.angleOffset)        
    const data = {
      degrees: this.angleOffset,
      textX: x,
      textY: y
    this.angleOffset = this.dataPercentage(dataVal) * 360 + this.angleOffset

Let’s also add a method to return the label string:

percentageLabel(dataVal) {
  return `${Math.round(this.dataPercentage(dataVal) * 100)}%`

And, in the markup:

{{ percentageLabel(value) }}

Now we’ve got labels:

See the Pen Donut Chart – Unformatted Labels by Salomone Baquis (@soluhmin ) on CodePen .

Blech, so off-center. We can fix this with the text-anchor presentation attribute. Depending on your font and font-size, you may want to adjust the positioning as well. Check out dx and dy for this.

Revamped text element:

{{ percentageLabel(value) }}

Hmm, it seems that if we have small percentages, the labels go outside of the segments. Let’s add a method to check for this.

segmentBigEnough(dataVal) {
  return Math.round(this.dataPercentage(dataVal) * 100) > 5
{{ percentageLabel(value) }}

Now, we’ll only add labels to segments larger than 5%.

And we’re done! We now have a reusable donut chart component that can accept any set of values and create segments. Super cool!

The finished product:

See the Pen Vue Donut Chart – Final Version by Salomone Baquis (@soluhmin ) on CodePen .

Next steps

There are lots of ways that we can modify or improve this now that it’s built. For example:

  • Adding elements to enhance accessibility, such as </code> and <code></code> tags, aria-labels, and aria role attributes.</li> <li>Creating <strong>animations</strong> with CSS or libraries like <a href="" class=" autoblog-load-by-popup thickbox">Greensock</a> to create eye-catching effects when the chart comes into view.</li> <li>Playing with <strong>color schemes</strong>.</li> </ul> <p>I’d love to hear what you think about this implementation and other experiences you’ve had with SVG charts. Share in the comments!</p> <p>The post <a rel="nofollow" href="" class=" autoblog-load-by-popup thickbox">Building a Donut Chart with Vue and SVG</a> appeared first on <a rel="nofollow" href="" class=" autoblog-load-by-popup thickbox">CSS-Tricks</a> .</p> <p><a href="" rel="nofollow" target="_blank">Original Article From CSS Tricks</a></p> </div><!-- .entry-content --> <footer class="entry-meta mobile-meta"> <span class="cat-links"> Posted in <a href="" rel="tag">CSS</a> </span> <span class="sep"> | </span> <span class="comments-link"><a href="">Leave a comment</a></span> <span class="sep"> | </span> </footer><!-- #entry-meta --> <nav id="nav-below"> <h1 class="assistive-text section-heading">Post navigation</h1> <div class="nav-previous"><a href="" rel="prev"><span class="meta-nav">← Previous</span></a></div> <div class="nav-next"><a href="" rel="next"><span class="meta-nav">Next →</span></a></div> </nav><!-- #nav-below --> </article><!-- #post-5842 --> <div class="grnbar"></div> <div id="comments" class="clearfix"> <div id="respond" class="comment-respond"> <h3 id="reply-title" class="comment-reply-title">Leave a Reply <small><a rel="nofollow" id="cancel-comment-reply-link" href="/building-a-donut-chart-with-vue-and-svg/#respond" style="display:none;">Cancel reply</a></small></h3> <form action="" method="post" id="commentform" class="comment-form"> <p class="comment-notes"><span id="email-notes">Your email address will not be published.</span> Required fields are marked <span class="required">*</span></p><p class="comment-form-comment"><label for="comment">Comment</label> <textarea id="comment" name="comment" cols="45" rows="8" maxlength="65525" required="required"></textarea></p><p class="comment-form-author"><label for="author">Name <span class="required">*</span></label> <input id="author" name="author" type="text" value="" size="30" maxlength="245" required='required' /></p> <p class="comment-form-email"><label for="email">Email <span class="required">*</span></label> <input id="email" name="email" type="text" value="" size="30" maxlength="100" aria-describedby="email-notes" required='required' /></p> <p class="comment-form-url"><label for="url">Website</label> <input id="url" name="url" type="text" value="" size="30" maxlength="200" /></p> <p class="form-submit"><input name="submit" type="submit" id="submit" class="submit" value="Post Comment" /> <input type='hidden' name='comment_post_ID' value='5842' id='comment_post_ID' /> <input type='hidden' name='comment_parent' id='comment_parent' value='0' /> </p><p style="display: none;"><input type="hidden" id="akismet_comment_nonce" name="akismet_comment_nonce" value="8ae600592c" /></p><p style="display: none;"><input type="hidden" id="ak_js" name="ak_js" value="4"/></p> </form> </div><!-- #respond --> </div><!-- #comments --> <div class="clearfix"></div> </div> <!-- end #main --> <div class="clearfix"></div> <div id="sidebar" class="widget-area clearfix" role="complementary"> <aside id="categories" class="widget"> <div class="widget-title">Categories</div> <ul> <li class="cat-item cat-item-4"><a href="" >CSS</a> </li> <li class="cat-item cat-item-10"><a href="" >Featured</a> </li> <li class="cat-item cat-item-5"><a href="" >jQuery/Javascript</a> </li> <li class="cat-item cat-item-7"><a href="" >Other Tech</a> </li> <li class="cat-item cat-item-6"><a href="" >Technopinions</a> </li> <li class="cat-item cat-item-3"><a href="" >Themes</a> </li> <li class="cat-item cat-item-1"><a href="" >Uncategorized</a> </li> <li class="cat-item cat-item-2"><a href="" >WordPress</a> </li> </ul> </aside> <aside id="recent-posts" class="widget"> <div class="widget-title">Recent Posts</div> <ul> <li><a href="" title="Look Rendering Lists Using React Virtualized" >Rendering Lists Using React Virtualized</a> </li> <li><a href="" title="Look Level up your JavaScript error monitoring" >Level up your JavaScript error monitoring</a> </li> <li><a href="" title="Look WordPress 5.0.1 Security Release" >WordPress 5.0.1 Security Release</a> </li> <li><a href="" title="Look Keep Math in the CSS" >Keep Math in the CSS</a> </li> <li><a href="" title="Look Web Designs That Feel Like Ancient History, but Are More Recent Than You Think" >Web Designs That Feel Like Ancient History, but Are More Recent Than You Think</a> </li> <li><a href="" title="Look Prototypes and production" >Prototypes and production</a> </li> <li><a href="" title="Look Creating an Animated Login Form for TouchID" >Creating an Animated Login Form for TouchID</a> </li> <li><a href="" title="Look What makes someone a good front-end developer?" >What makes someone a good front-end developer?</a> </li> <li><a href="" title="Look Why isn’t it <style src=””>?" >Why isn’t it <style src=””>?</a> </li> <li><a href="" title="Look An Introduction and Guide to the CSS Object Model (CSSOM)" >An Introduction and Guide to the CSS Object Model (CSSOM)</a> </li> </ul> </aside> <aside id="popular-posts" class="widget"> <div class="widget-title">Popular Posts</div> <ul> <li> <a href="" title="Top 10 WordPress Podcasts You Should Tune Into Right Now">Top 10 WordPress Podcasts You Should Tune Into Right Now</a> </li> <li> <a href="" title="The universe is smiling at us">The universe is smiling at us</a> </li> <li> <a href="" title="Styled Range Sliders">Styled Range Sliders</a> </li> <li> <a href="" title="Five Easy Ways to Be a Better Web Professional">Five Easy Ways to Be a Better Web Professional</a> </li> <li> <a href="" title="Responsible Social Share Links">Responsible Social Share Links</a> </li> <li> <a href="" title="Inline SVG with Grunticon Fallback">Inline SVG with Grunticon Fallback</a> </li> <li> <a href="" title="Ol’ John Henry: Can Web Design Beat the Machines?">Ol’ John Henry: Can Web Design Beat the Machines?</a> </li> <li> <a href="" title="Spriting with <img>">Spriting with <img></a> </li> <li> <a href="" title="Transitioning to SCSS at Scale">Transitioning to SCSS at Scale</a> </li> <li> <a href="" title="Rendering Lists Using React Virtualized">Rendering Lists Using React Virtualized</a> </li> </ul> </aside> <aside id="archives" class="widget"> <div class="widget-title">Archives</div> <ul> <li><a href=''>December 2018</a></li> <li><a href=''>November 2018</a></li> <li><a href=''>October 2018</a></li> <li><a href=''>September 2018</a></li> <li><a href=''>August 2018</a></li> <li><a href=''>July 2018</a></li> <li><a href=''>June 2018</a></li> <li><a href=''>May 2018</a></li> <li><a href=''>April 2018</a></li> <li><a href=''>March 2018</a></li> <li><a href=''>February 2018</a></li> <li><a href=''>January 2018</a></li> <li><a href=''>December 2017</a></li> <li><a href=''>November 2017</a></li> <li><a href=''>October 2017</a></li> <li><a href=''>September 2017</a></li> <li><a href=''>August 2017</a></li> <li><a href=''>July 2017</a></li> <li><a href=''>June 2017</a></li> <li><a href=''>May 2017</a></li> <li><a href=''>April 2017</a></li> <li><a href=''>March 2017</a></li> <li><a href=''>February 2017</a></li> <li><a href=''>January 2017</a></li> <li><a href=''>December 2016</a></li> <li><a href=''>November 2016</a></li> <li><a href=''>October 2016</a></li> <li><a href=''>September 2016</a></li> <li><a href=''>August 2016</a></li> <li><a href=''>July 2016</a></li> <li><a href=''>June 2016</a></li> <li><a href=''>May 2016</a></li> <li><a href=''>April 2016</a></li> <li><a href=''>March 2016</a></li> <li><a href=''>February 2016</a></li> <li><a href=''>January 2016</a></li> <li><a href=''>December 2015</a></li> <li><a href=''>November 2015</a></li> <li><a href=''>October 2015</a></li> <li><a href=''>September 2015</a></li> <li><a href=''>August 2015</a></li> <li><a href=''>July 2015</a></li> <li><a href=''>June 2015</a></li> <li><a href=''>May 2015</a></li> <li><a href=''>April 2015</a></li> <li><a href=''>March 2015</a></li> <li><a href=''>February 2015</a></li> </ul> </aside> </div><!-- #sidebar .widget-area --> </div> <!-- end #content --> <footer id="colophon" role="contentinfo"> <div id="site-generator"> © A Geek's View<p>INSIGHTS FROM A GEEK</p> </div> </footer><!-- #colophon --> </div><!-- #container --> <script type='text/javascript'> /* <![CDATA[ */ var thickboxL10n = {"next":"Next >","prev":"< Prev","image":"Image","of":"of","close":"Close","noiframes":"This feature requires inline frames. You have iframes disabled or your browser does not support them.","loadingAnimation":"http:\/\/\/wp-includes\/js\/thickbox\/loadingAnimation.gif"}; /* ]]> */ </script> <script type='text/javascript' src=''></script> <script type='text/javascript' src=''></script> <script type='text/javascript' src=''></script> <script async="async" type='text/javascript' src=''></script> <script type='text/javascript'> /* <![CDATA[ */ var mailchimp_form_captions = {"ajaxurl":"http:\/\/\/wp-admin\/admin-ajax.php","nonce":"43e3825d1a"}; /* ]]> */ </script> <script type='text/javascript' src=''></script> <script type="text/javascript"> jQuery(document).ready(function(){ var width = (jQuery(window).width() * 90)/100; var height =(jQuery(window).height() * 90)/100; jQuery(".autoblog-load-by-popup").each(function(){ jQuery(this).attr("href",jQuery(this).attr("href")+"?TB_iframe=true&width="+width+"&height="+height) }) }) </script> </body> </html>