netes / ember-d3

Ember CLI addon to include D3 as an ES2015 module in your app.

ember-d3

Ember shim for loading [email protected]. To install:

ember install ember-d3

Important: You must be using NPM >= 3.0 and Node >= 4.0 for this to work,
or you'll get errors when you start your app. Check by running npm version.

You can upgrade NPM by running:

npm i -g npm@3

D3 modules are loaded from NPM as ES2015 modules. It includes d3-shape and all version 4 modules in D3 4.x.

If you're looking for the ember-d3 for [email protected], see the v3 branch.

Advanced Installation

If you need a specified d3 version, add this to your project:

npm install --save-dev [email protected]

Example usage:

import { line } from 'd3-shape';
import { scaleOrdinal } from 'd3-scale';
import { extent } from 'd3-array';

We've put together a complete demo component which you can use to really get a feel for how to use the different packages provided by this addon.

Specifying the d3 version

This addon is simply a loader for the d3 NPM package. If you would like to specify a specific version on the d3 v4.x track, you can do so by installing that version directly in your project, and this addon will load that version.

Svelte Builds

In case you do not want to include all of d3's dependencies, you may whitelist the packages that you want to include in your project's config/environment.js file.

For example, if you only wanted to use d3-scale, you would do:

// config/environment.js
module.exports = function() {
  return {
    'ember-d3': {
      only: ['d3-scale']
    }
  };
};

Or if you want to exclude a package:

// config/environment.js
module.exports = function() {
  return {
    'ember-d3': {
      except: ['d3-scale']
    }
  };
};

Note: Even though you only add d3-scale, it has a few transitive d3 dependencies. These are added to your project automatically.

Running Tests

• npm test (Runs ember try:testall to test your addon against multiple Ember versions)
• ember test
• ember test --server