D3 Service for Angular
With the release of version 4, D3 has been completely modularized and seen enhancements, which make it all the more powerful, yet easy to use.
Amongst the many changes since the release of Angular 2, the native support for developing at scale in TypeScript and the overhauled componentized structure are but two.
Combining the power of D3 and Angular can be challenging at first. The intent of this package is to provide a simple way to access D3 as an Angular service for use by components requiring the kind of sophisticated visualization support D3 excels at. The package includes TypeScript definitions to improve development experience and code maintainability.
This package was designed to quickly add D3 support to an Angular application, such as those created with the angular-cli.
As is clear from the D3 scope described below, there may be circumstances, where a smaller or larger D3 feature set may be better suited for a given project. In such cases, reviewing the TypeScript source code in this package's Github repo may serve as a starting point for a more tailored solution.
A suggested approach may also involve starting out with the d3-ng2-service for rapid prototyping. Then, once there is more stability regarding the specific, required D3 feature set,
the D3 service pattern can be preserved by implementing the minimally viable D3 service directly in the project. This amounts to manually "treeshaking" D3 in order to preserve the
convenience of accessing D3 functions through a
For those interested in using the treeshaking performed "automatically" by third party build/bundling tools, it may be better to import the minimally required D3 functionality directly at component level. Following this strategy, may require added care to mind D3 cross-module prototype extensions (i.e. ordering of imports) and ensuring a live-binding to
d3.event is in place, if any functionality based on
d3.event is used.
Scope of D3 Functionality
As this package is designed for use with Angular, it does not strictly mirror the functionality scope included in the D3 Standard Bundle.
The d3-fetch module has been omitted as a design choice given the feature set of Angular. By implication, it is recommended to utilize e.g. Angular's
HttpClient for client/server communication. The
d3-ng2-service package does, however, expose D3 data parsing functionality such as
The functionality enhancements provided by the now separate d3-selection-multi module have been included for added convenience.
For a complete list of D3 modules included, please refer to the
package.json dependencies here.
At present, included modules are provided in their entirety.
To include the package into your Angular project, simply use the standard npm package installation command:
npm install d3-ng2-service --save
Please note that the package has a peer dependency on @angular/core.
Once the module
d3-ng2-service has been added to a project as described above, it provides the following importable exports:
D3Service: The Angular D3 Service injectable,
D3: A TypeScript type alias for the
d3variable which can be obtained from the
- the various TypeScript interfaces and type aliases which are related to the D3 modules constituting
d3as provided by this service (e.g.
To obtain the
d3 object from an injected D3 service
d3Service: D3Service, it offers a method
d3Service.getD3() with return type
The below code snippets assume the use of TypeScript.
Step 1 - Registering the Service with an Angular Module
Import the Angular service and register it as a provider with an Angular module.
;;;;;; // <-- import statement
Step 2 - Using the Service with an Angular Component
Important: The component is declared in the same module as the
D3Service provider has been registered.
Import the D3 service and then pass the service into the component constructor together with
d3 from the D3 service and use it to perform the required tasks.
;; // <-- import the D3 Service, the type alias for the d3 variable and the Selection interface
For a more complete worked example of how this module can be used in an angular-cli created D3 Demo App, please see: