Skip to content
Swizec Teller - a geek with a

A Drilldown Piechart with React and D3

A few days ago Kiran B sent me a challenge via Twitter DM: How can I make a drilldown piechart?


The annoyed emoji is a bit much but I'll allow it. The challenge was fun to solve. Got it roughly working in a 45min stream πŸ‘‡

You can also try it out via CodeSandbox. I'm surprised how nice default D3 category colors work with a black border. It's gorgeous 😍


Click through for source
Click through for source

Here's how a drilldown piechart works

You can think of a drilldown piechart as a recursive data visualization. Take a tree structure of data and you render a piechart for each level. Click on a slice, drill down into that branch.

Easiest way to get started is to generate that dataset from scratch ✌️

Click through for source
Click through for source

Random number of datapoints, N, create an array with d3.range, loop through, generate a datapoint for each step. Random value, some identifier, save the level of recursing, the index, the parent index, a name, and then generate some children.

Generating children calls this same function thus creating a recursive data structure.


We'll use the level and index and previous index to help us pick slice colors later on.

I like to keep my <App> component simple so using the data and rendering the piechart looks like this:

Click through for source
Click through for source

An svg element with a <DrilldownPie> component.

DrilldownPie component

Ok the colors aren't perfect, the drilling down is confusing without an animation, and you can't drill up just yet. But it's a great start!

Three components play together:

  1. A styled <Path> component handles colors
  2. An <Arc> component renders arcs, deals with mouseovers, and registers clicks
  3. A <DrilldownPie> component holds it all together and deals with drilling


The <Path> component is a styled SVG path that uses props to decide the color of each slice.

Click through for source
Click through for source

Level 4 is the top level πŸ‘‰ use a color scheme from D3 and the slice index to pick a color.

With other levels the idea was to take the base color and make it progressively brighter based on the index. Works okay for the first level down, didn't quite work later on.

Might have to change how we approach this. Maybe colors as part of the dataset itself?

thinking_hard giphy


The <Arc> component renders a single slice of the piechart and handles mouseover events using hooks to change size. Messing with the radius creates the effect of individual slices popping out.

Click through for source
Click through for source

That's the whole component. Let's break it down :)

First we've got the state management: A single radiusAdd variable that tells us how much to add or take away from the default radius of our arc.

Second we've got the d3.arc generator. Takes some configuration and produces path definitions using SVG's crazy path language.

Third we've got 2 functions calling the setRadiusAdd setter to change the radius. That triggers a re-render, the arc generator sees the new value, creates a different path definition πŸ‘Œ

Fourth we render our styled <Path> component making sure to pass in all the right props. The path definition, the level and index for color, and all the event listeners.


The <DrilldownPie> component ties this all together.

Click through for source
Click through for source

Less code even than the Arc component god I love hooks 😱

First we've got state. We copy our data into it. That's so we can do the drilling down. Haven't tried how this plays with data changing from the outside ... trigger a re-render I assume πŸ€”

Second we've got a d3.pie generator. Takes our data and creates an array of objects perfectly suited for the d3.arc generator. Angles and values and all.

Third the drilldown function uses our state setter to move data one level down. Take the children, set them as current data, trigger re-render, magic. πŸ§™β€β™‚οΈ

Fourth render it all in a loop.

And that's how you build a drilldown piechart with React and D3 and hooks.

Click through for source
Click through for source


I'm going to continue this challenge either Friday night (today) or Sunday afternoon. Want to figure out how to make the drilldown transition animated and get drilling up to work.

Drilling up is easy in principle, but gets tricky if you want to support arbitrary levels. That's because we aren't using real recursion to drill down πŸ˜…

See you at the stream maybe?

Cheers, ~Swizec

Did you enjoy this article?

Published on June 28th, 2019 in Front End, Technical

Learned something new?
Want to become a high value JavaScript expert?

Here's how it works πŸ‘‡

Leave your email and I'll send you an Interactive Modern JavaScript Cheatsheet πŸ“–right away. After that you'll get thoughtfully written emails every week about React, JavaScript, and your career. Lessons learned over my 20 years in the industry working with companies ranging from tiny startups to Fortune5 behemoths.

Start with an interactive cheatsheet πŸ“–

Then get thoughtful letters πŸ’Œ on mindsets, tactics, and technical skills for your career.

"Man, love your simple writing! Yours is the only email I open from marketers and only blog that I give a fuck to read & scroll till the end. And wow always take away lessons with me. Inspiring! And very relatable. πŸ‘Œ"

~ Ashish Kumar

Join over 10,000 engineers just like you already improving their careers with my letters, workshops, courses, and talks. ✌️

Have a burning question that you think I can answer?Β I don't have all of the answers, but I have some! Hit me up on twitter or book a 30min ama for in-depth help.

Ready to Stop copy pasting D3 examples and create data visualizations of your own? Β Learn how to build scalable dataviz components your whole team can understand with React for Data Visualization

Curious about Serverless and the modern backend? Check out Serverless Handbook, modern backend for the frontend engineer.

Ready to learn how it all fits together and build a modern webapp from scratch? Learn how to launch a webapp and make your first πŸ’° on the side with ServerlessReact.Dev

Want to brush up on your modern JavaScript syntax?Β Check out my interactive cheatsheet:

By the way, just in case no one has told you it yet today: I love and appreciate you for who you are ❀️