D3

Bring data to life with SVG, Canvas and HTML.

ChartingD3SVGCanvas
d3/d3d3js.orgd3

README

D3: Data-Driven Documents



D3 (or D3.js) is a JavaScript library for visualizing data using web standards. D3 helps you bring data to life using SVG, Canvas and HTML. D3 combines powerful visualization and interaction techniques with a data-driven approach to DOM manipulation, giving you the full capabilities of modern browsers and the freedom to design the right visual interface for your data.

Resources


Introduction
API Reference
Releases
Examples
Wiki

Installing


If you use npm, npm install d3. You can also download the latest release on GitHub. For vanilla HTML in modern browsers, import D3 from Skypack:

  1. ``` html
  2. <script type="module">
  4. import * as d3 from "https://cdn.skypack.dev/d3@7";
  6. const div = d3.selectAll("div");
  8. </script>
  9. ```

For legacy environments, you can load D3’s UMD bundle from an npm-based CDN such as jsDelivr; a d3 global is exported:

  1. ``` html
  2. <script src="https://cdn.jsdelivr.net/npm/d3@7"></script>
  3. <script>
  5. const div = d3.selectAll("div");
  7. </script>
  8. ```

You can also use the standalone D3 microlibraries. For example, d3-selection:

  1. ``` html
  2. <script type="module">
  4. import {selectAll} from "https://cdn.skypack.dev/d3-selection@3";
  6. const div = selectAll("div");
  8. </script>
  9. ```

D3 is written using ES2015 modules. Create a custom bundle using Rollup, Webpack, or your preferred bundler. To import D3 into an ES2015 application, either import specific symbols from specific D3 modules:

  1. ``` js
  2. import {scaleLinear} from "d3-scale";
  3. ```

Or import everything into a namespace (here, d3):

  1. ``` js
  2. import * as d3 from "d3";
  3. ```

Or using dynamic import:

  1. ``` js
  2. const d3 = await import("d3");
  3. ```

You can also import individual modules and combine them into a d3 object using Object.assign:

  1. ``` js
  2. const d3 = await Promise.all([
  3.   import("d3-format"),
  4.   import("d3-geo"),
  5.   import("d3-geo-projection")
  6. ]).then(d3 => Object.assign({}, ...d3));
  7. ```