AngularJS v2.x directives for AnyChart provide an easy way to use AnyChart JavaScript Charts with Angular2 Framework.
You can install Angular2-plugin using npm, bower or yarn:
npm install anychart-angular2
bower install anychart-angular2
yarn add anychart-angular2
You can download compiled Angular2 components directly from the dist folder.
Please, note: components.js and components.d.ts files export basic Anychart-Angular2 integration functionality.
Here's a basic sample that shows how to quickly create an Angular2 application with AnyChart component.
Create a project derictory and enter into it.
Install Angular2-plugin:
npm install anychart-angular2
Paste systemjs.config.js
file into this derictory. You can get this file from one of demos.
Create index.html
file with the following template:
<!DOCTYPE html>
<html>
<head>
<title>Angular Quick Start</title>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<!-- Polyfill(s) for older browsers -->
<script src="https://github.com/AnyChart/AnyChart-AngularJS-v2.x/raw/master/./node_modules/core-js/client/shim.min.js"></script>
<!-- Add zone.js (https://github.com/angular/zone.js/) -->
<script src="https://github.com/AnyChart/AnyChart-AngularJS-v2.x/raw/master/./node_modules/zone.js/dist/zone.js"></script>
<!-- Add modules loader -->
<script src="https://github.com/AnyChart/AnyChart-AngularJS-v2.x/raw/master/./node_modules/systemjs/dist/system.src.js"></script>
<!-- Include anychart component -->
<script src="https://github.com/AnyChart/AnyChart-AngularJS-v2.x/raw/master/./node_modules/anychart/dist/anychart-bundle.min.js"></script>
<!-- General section, this configuration adds all the requirements to run -->
<script src="https://github.com/AnyChart/AnyChart-AngularJS-v2.x/raw/master/systemjs.config.js"></script>
<script>
//Import of application to run.
System.import('app').catch(function(err){ console.error(err); });
</script>
</head>
<body>
<my-app>Loading AppComponent content here ...</my-app>
</body>
</html>
Also, in this directory you should create the app folder and Angular application file /app/main.js:
.
1) Go to any of demos
directory
2) Install all dependencies with npm install
command.
3) Start the demo with npm run start
command.
1) Despite the AnyChart-Angular2 integration is available with package managers, the license allows to modify and use it freely (though you need AnyChart license to use the library itself in commercial projects). This quick start guide clarifies the structure of integration project and explains how it works and how it can be used.
If the integration is cloned from GitHub and Node Package Manager (npm
command) is available in command line, the following command compiles source code to dist/ directory:
npm run build
2) If needed, package.json
of demo-application can be configured to declare custom run-commands
and to add required dependencies excepting already included.
3) Run npm install
command to load all required npm modules.
4) Configure systemjs.config.js
to declare the mapping of dependencies of
application (see any demo
to see the basic configuration). In 'map'-section AnyChart integration library is declared:
...
'anychart-angular2': 'node_modules/anychart-angular2'
5) In 'packages'-section anychart-angular2 library is declared:
'anychart-angular2': {
main: 'index'
}
6) These actions allow to use anychart-angular2 integration in an application like one described in Quick start.
7) Since 'app' folder is declared in systemjs.config.js
as application root
directory, the application's Angular2 modules and components can be created
right there.
├── def
│ ├── anychart.d.ts
│ ...
├── dist
│ ├── anychart.directive.d.ts
│ ├── anychart.directive.js
│ ...
├── src
│ ├── anychart.directive.ts
│ ├── anychart.service.ts
│ ...
│ components.d.ts
│ components.js
│ package.json
│ LICENSE
│ README.md
│ ...
def/anychart.d.ts - Anychart typescript definition file. Used to correctly compile source code to dist/ directory.
dist/ -
Output directory that contains compiled js
and d.ts
files. The general component
declarations (components.js and components.d.ts) rely on this directory
content.
src/ - Source code directory. Contains Angular2-compatible components to provide AnyChart integration.
components.d.ts and components.js - Components definition. Relies on dist/ directory content.
package.json - Package manager configuration file. Also contains descriptions of available run commands (including build command) and the list of dependencies.
See these samples to learn how things work:
anychart-stage
directive to build an interactive dashboard.AnyChart Angular2 plugin includes two parts:
If you have any questions regarding licensing - please contact us. sales@anychart.com