Swizec Teller - a geek with a hatswizec.com

    Livecoding #24: A choropleth in React.js

    This is a Livecoding Recap – an almost-weekly post about interesting things discovered while livecoding ?. Always under 500 words and with pictures. You can follow my channel, here. New content almost every Sunday at 2pm PDT. There’s live chat, come say hai ?

    I just spent 3 hours normalizing datasets. Then I wrote a script that did it in less than 5 seconds. I am not a smart man.

    Did you know there were 32 states with a Washington county in the US? And there are 24 Jackson counties? 16 Wayne counties… 12 Marshalls… ?

    County names are only unique per-state, not per-all-of-the-country. Now you know. And now I know, too!

    Fixing that problem let me turn this picture from livecoding:


    Into this picture:


    The latter has less gray and more blue. That’s good. It means there are fewer counties that didn’t match our dataset. Some remain. I don’t know how to fix those.

    You’re looking at a choropleth map of median household incomes in the United States that I built with React and D3v4.

    Buffalo County in South Dakota is the poorest county in the US with a median household income of $21,658. City of Falls Church County in Virginia is the richest with $125,635. Richest part of the country is about 6x richer than the poorest. ?

    These are medians we’re talking about, not maximums. In both cases, 90% of households fall within a few thousand dollars of the median.

    More about that later this week when we compare this median household data to that dataset of salaries in the software industry. That should be fun ?

    Here’s how it’s built

    We cribbed off of Mike Bostock’s choropleth example and modified it for React.

    After loading our datasets – a TopoJSON of US counties and states (geo info) and a table of median household incomes per county – we start with a CountyMap component. It draws the overall map and deals with calculating the quantize threshold scale for colors.

    The component is about 50 lines, so I added comments to each method.

    class CountyMap extends Component {
    // Setup default D3 objects
    // projection - defines our geo projection, how the map looks
    // geoPath - calculates d attribute of <path> so it looks like a map
    // quantize - threshold scale with 9 buckets
    constructor(props) {
    this.projection = d3.geoAlbersUsa()
    this.geoPath = d3.geoPath()
    this.quantize = d3.scaleQuantize()
    // update D3 objects when props update
    componentWillReceiveProps(newProps) {
    // Re-center the geo projection
    // Update domain of quantize scale
    updateD3(props) {
    this.projection.translate([props.width / 2, props.height / 2]);
    if (props.medianIncomes) {
    this.quantize.domain([10000, 75000]);
    // If no data, do nothing (we might mount before data loads into props)
    render() {
    if (!this.props.usTopoJson) {
    return null;
    // Translate topojson data into geojson data for drawing
    // Prepare a mesh for states and a list of features for counties
    const us = this.props.usTopoJson,
    statesMesh = topojson.mesh(us, us.objects.states, (a, b) => a !== b),
    counties = topojson.feature(us, us.objects.counties).features;
    // Loop through counties and draw <county> components
    // Add a single <path> for state borders
    return (
    {counties.map((feature) => <county geopath={this.geoPath} feature={feature} key={feature.id} quantize={this.quantize} data="{_.find(this.props.medianIncomes," {countyid:="" feature.id})}="">)}
    <path d={this.geoPath(statesMesh)} style="{{fill:" 'none',="" stroke:="" '#fff',="" strokelinejoin:="" 'round'}}="">

    I hope that makes sense. It follows my standard React+D3js approach.

    For the counties, we can use a stateless functional component that gets all relevant data through props. It looks like this:

    // Combine array of colors and quantize scale to pick fill colo
    // Return a <path> element
    const County = ({ data, geoPath, feature, quantize }) => {
    let color = BlankColor;
    if (data) {
    color = ChoroplethColors[quantize(data.medianIncome)];
    return (<path d={geoPath(feature)} style="{{fill:" color}}="" title={feature.id}>)

    With some setup and a bit of data loading, those two components create a choropleth map of median household incomes in the United States. Watch the video to see how it all fits together.

    P.S.: the edited and improved versions of these videos are becoming a video course. Readers of the engineer package of React+d3js ES6 get the video course for free when it’s ready.

    Did you enjoy this article?

    Published on October 3rd, 2016 in d3, d3js, Livecoding, react+d3js, reactjs, Technical

    Learned something new?
    Want to become an expert?

    Here's how it works 👇

    Leave your email and I'll send you thoughtfully written emails every week about React, JavaScript, and your career. Lessons learned over 20 years in the industry working with companies ranging from tiny startups to Fortune5 behemoths.

    Join Swizec's Newsletter

    And get thoughtful letters 💌 on mindsets, tactics, and technical skills for your career. Real lessons from building production software. No bullshit.

    "Man, love your simple writing! Yours is the only newsletter I open 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 14,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: es6cheatsheet.com

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

    Created by Swizec with ❤️