Skip to content

cid-harvard/react-canvas-treemap

Repository files navigation

react-canvas-treemap

by the Growth Lab at Harvard's Center for International Development

Canvas based Treemap data visualization using React.

This package is part of Harvard Growth Lab’s portfolio of software packages, digital products and interactive data visualizations. To browse our entire portfolio, please visit The Viz Hub at growthlab.app. To learn more about our research, please visit Harvard Growth Lab’s home page.

NPM JavaScript Style Guide

Install

npm install --save react-canvas-treemap

Usage

import React from 'react'
import TreeMap, {transformData} from 'react-canvas-treemap';

const App = () => {

  ...
  const data = transformData({
    data: fetchedData,
    width: 500,
    height: 500,
    colorMap: colorMap,
  });

  return (
    <TreeMap
      highlighted={undefined}
      cells={data.treeMapCells}
      numCellsTier={0}
      chartContainerWidth={500}
      chartContainerHeight={500}
      onCellClick={id => console.log(id)}
      onMouseOverCell={id => console.log(id)}
      onMouseLeaveChart={() => {}}
    />
  )
}

export default App

The TreeMap component takes the following props:

  • highlighted: string | undefined
  • cells: ITreeMapCell[]
  • comparisonTreeMap (optional): boolean
  • fallbackTitle (optional): string
  • numCellsTier: NumCellsTier
  • chartContainerWidth: number
  • chartContainerHeight: number
  • onCellClick: (id: string) => void
  • onMouseOverCell: (id: string) => void
  • onMouseLeaveChart: () => void

License

MIT © The President and Fellows of Harvard College

⚠️ License: While this package has a MIT license, it uses Greensock, which is not an Open-Source software. All of the Greensock Code used here falls within their "No Charge" License. If you intend to use this package, make sure to familiarize yourself with the Greensock "No Charge" License.