Ever wondered, how to build modern web apps with reusable, interactive data visualization components?
The latest incarnation of D3 is getting you excited about new destinations. Angular 2 arrived on the tarmac and has since been rolled into a stable release management cycle. TypeScript has become the fuel that lets you develop complex solutions at scale.
Integrating all three, however, seems as daunting as taking off in the perfect storm.
This Angular demo app is intended to get you started. Rather than trying to be exhaustive or writing a lengthy blog post, a select few well-known D3 demo scripts have been adapted to highlight key considerations:
-
use an Angular Service to inject the power of D3 version 4 into a project,
-
explore how D3 visualizations can be implemented as Angular components in TypeScript 2,
-
see how a visualization component can change in response to input data changes,
-
find ways to unit test your D3 components with Karma/Jasmine, and
-
check out an example end-to-end test using Protractor.
The running web app can be seen at: d3-ng2-demo Github Page.
This project was generated with angular-cli.
In order to explore the project locally:
- clone this git repository using
git clone https://github.com/tomwanzek/d3-ng2-demo.git, - change into the project directory
cd d3-ng2-demo, and - run
npm install.
Now you are ready to explore the source code and use the features provided by angular-cli for your convenience. A brief overview of the command line support provided by angular-cli is sketched out in the following subsections.
Run ng serve for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.
Run ng generate component component-name to generate a new component. You can also use ng generate directive|pipe|service|class|guard|interface|enum|module.
Run ng build to build the project. The build artifacts will be stored in the dist/ directory. Use the -prod flag for a production build.
Run ng test to execute the unit tests via Karma.
Run ng e2e to execute the end-to-end tests via Protractor.
To get more help on the Angular CLI use ng help or go check out the Angular CLI README.