API Reference

Everything in D3 is scoped under the d3 namespace. D3 is broken up into several modules so that you can pick and choose which features you need and minimize the weight. The default build of d3.js includes the core, scale and svg modules, at about 12KB uglified and gzipped. However, you can edit the Makefile to produce a custom build that suites your needs. D3 does not introduce anything else in the global namespace. However, for nonstandard browsers we do register polyfills for Date.now and Object.create.

D3 uses semantic versioning. You can find the current version of D3 as d3.version.

d3 (core)

Selections

• d3.select - select an element from the current document.
• d3.selectAll - select multiple elements from the current document.
• d3.ns - access or extend known XML namespaces.
• d3.functor - create a function that returns a constant.

Transitions

• d3.transition - start an animated transition.
• d3.ease - customize transition timing.
• d3.interpolate - interpolate two values.
• d3.interpolateNumber - interpolate two numbers.
• d3.interpolateRound - interpolate two integers.
• d3.interpolateString - interpolate two strings.
• d3.interpolateRgb - interpolate two RGB colors.
• d3.interpolateHsl - interpolate two HSL colors.
• d3.interpolateArray - interpolate two arrays of values.
• d3.interpolateObject - interpolate two arbitrary objects.

Events

• d3.dispatch - create a custom event dispatcher.
• d3.event - access the current user event for interaction.

Working with Arrays

• d3.ascending - compare two values for sorting.
• d3.descending - compare two values for sorting.
• d3.min - find the minimum value in an array.
• d3.max - find the maximum value in an array.
• d3.keys - list the keys of an associative array.
• d3.values - list the values of an associated array.
• d3.entries - list the key-value entries of an associative array.
• d3.split - split an array into multiple arrays.
• d3.merge - merge multiple arrays into one array.
• d3.range - generate a range of numeric values.
• d3.nest - group array elements hierarchically.

Loading External Resources

• d3.xhr - load a resource using XMLHttpRequest.
• d3.text - load a text file.
• d3.json - load a JSON blob.
• d3.html - load an HTML document fragment.
• d3.xml - load an XML document fragment.

Also see the csv module.

Number Formatting

• d3.format

Colors

• d3.rgb
• d3.hsl

d3.behavior

d3.chart

d3.csv

d3.geo

d3.geom

d3.layout

d3.scale

d3.svg

d3.time