d3plus-react v1.3.3

d3plus-react

React components for d3plus visualizations.

Installing

Use npm install d3plus-react -S to install the package as a dependency.

Configuration

A valid d3plus config Object needs to be provided to the config prop of every visualization.

import {Treemap} from "d3plus-react";

const methods = {
  groupBy: "id",
  data: [
    {id: "alpha", value: 29},
    {id: "beta",  value: 10}
  ],
  size: d => d.value
};

<Treemap config={methods} />

Additionally, a global set of styles can be provided using the "d3plus" React context key. This allows you to set base styles on all of your visualizations in one place, often in an external file. A component's config set by props will override global defaults key-by-key using a deep cloning function.

import React, {Component} from "react";

export default class MyApp extends Component {

  getChildContext() {

    return {
      d3plus: {
        shapeConfig: {
          fontFamily: "Comic Sans MS"
        }
      }
    };

  }

  render() {

    return (
      <main>
        {/* child components containing visualizations */}
      </main>
    );

  }

}

MyApp.childContextTypes = {
  d3plus: PropTypes.object
};

Update Cycle

In order to detect whether a component should udpate in React, each component does a rudimentary check between the current config object and the incoming new config object. This is done via a simple equality check on the stringified versions of each object. This can also be overridded using the forceUpdate prop:

const shouldUpdate = this.props.forceUpdate ? false : JSON.stringify(oldConfig) === JSON.stringify(newConfig);

This works in most cases, but may not update your visualizations if using an accessor function that references an external variable. For example, if your x accessor is:

const config = {
  ...,
  x: d => d[xVar]
};

...and xVar changes, the visualization will not update. The quick "hack" for this is add xVar to the config object so that it triggers the update via stringify:

const config = {
  ...,
  x: d => d[xVar],
  xVar
};

API Reference

• AreaPlot
• BarChart
• BoxWhisker
• BumpChart
• D3plusContext - A React context instance used to provide global config options via a provider (D3plusContext.Provider).
• Donut
• Geomap
• LinePlot
• Matrix
• Network
• Pack
• Pie
• Plot
• Priestley
• Radar
• RadialMatrix
• Rings
• Sankey
• StackedArea
• Tree
• Treemap
• Viz - Creates SVG paths and coordinate points based on an array of data. See this example for help getting started using the geomap generator.

d3plus.AreaPlot() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.BarChart() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.BoxWhisker() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.BumpChart() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.D3plusContext() <>

A React context instance used to provide global config options via a provider (D3plusContext.Provider).

This is a global function.

d3plus.Donut() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.Geomap() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.LinePlot() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.Matrix() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.Network() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.Pack() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.Pie() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.Plot() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.Priestley() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.Radar() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.RadialMatrix() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.Rings() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.Sankey() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.StackedArea() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.Tree() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.Treemap() <>

This is a global function, and extends all of the methods and functionality of Viz.

d3plus.Viz() <>

Creates SVG paths and coordinate points based on an array of data. See this example for help getting started using the geomap generator.

This is a global function.

# .module.exports <>

This is a static property of Viz.

Documentation generated on Tue, 26 Mar 2024 18:14:38 GMT