Official Angular plugin for amCharts V3
-
If you are using Angular 12 or higher:
npm install @amcharts/amcharts3-angular --save -
If you are using Angular 5 to 11:
npm install @amcharts/amcharts3-angular^2.2.5 --save -
If you are using Angular 2 to 4:
npm install @amcharts/amcharts3-angular@^1.5.0 --save
- In your
index.htmlfile, load the amCharts library using<script>tags:
<script src="https://www.amcharts.com/lib/3/amcharts.js"></script>
<script src="https://www.amcharts.com/lib/3/serial.js"></script>
<script src="https://www.amcharts.com/lib/3/themes/light.js"></script>If you are using stock charts, you should use these <script> tags instead:
<script src="https://www.amcharts.com/lib/3/amcharts.js"></script>
<script src="https://www.amcharts.com/lib/3/serial.js"></script>
<script src="https://www.amcharts.com/lib/3/amstock.js"></script>
<script src="https://www.amcharts.com/lib/3/themes/light.js"></script>If you are using maps, you should use these <script> tags instead:
<script src="https://www.amcharts.com/lib/3/ammap.js"></script>
<script src="https://www.amcharts.com/lib/3/maps/js/worldLow.js"></script>
<script src="https://www.amcharts.com/lib/3/themes/light.js"></script>If you are using other chart types, you should change serial.js to the chart type that you are using:
<script src="https://www.amcharts.com/lib/3/amcharts.js"></script>
<script src="https://www.amcharts.com/lib/3/pie.js"></script>
<script src="https://www.amcharts.com/lib/3/themes/light.js"></script>- In your app component, import the
AmChartsModulemodule and add it to theimports:
import { Component } from '@angular/core';
import { CommonModule } from '@angular/common';
import { RouterOutlet } from '@angular/router';
import { AmChart, AmChartsService, AmChartsModule } from '@amcharts/amcharts3-angular';
@Component({
selector: 'app-root',
standalone: true,
// Add the import here
imports: [CommonModule, RouterOutlet, AmChartsModule],
templateUrl: './app.component.html',
styleUrl: './app.component.css'
})
export class AppComponent {- Inject the
AmChartsServiceinto your app component, create a<div>element with anid, then use themakeChartmethod to create the chart:
<div id="chartdiv" [style.width.%]="100" [style.height.px]="500"></div>import { Component } from '@angular/core';
import { CommonModule } from '@angular/common';
import { RouterOutlet } from '@angular/router';
import { AmChart, AmChartsService, AmChartsModule } from '@amcharts/amcharts3-angular';
@Component({
selector: 'app-root',
standalone: true,
// Add the import here
imports: [CommonModule, RouterOutlet, AmChartsModule],
templateUrl: './app.component.html',
styleUrl: './app.component.css'
})
export class AppComponent {
private chart: AmChart | undefined;
// Inject the service here
constructor(private AmCharts: AmChartsService) {}
ngAfterViewInit() {
this.chart = this.AmCharts.makeChart("chartdiv", {
"type": "serial",
"theme": "light",
"dataProvider": []
...
});
}
ngOnDestroy() {
if (this.chart) {
this.AmCharts.destroyChart(this.chart);
}
}
}The first argument to makeChart must be the same as the <div>'s id. The id can be whatever you want, but if you display multiple charts each chart must have a different id
When you are finished with the chart, you must call the destroyChart method. It's good to put this inside the ngOnDestroy method.
- If you want to change the chart after the chart has been created, you must make the changes using the
updateChartmethod:
// This must be called when making any changes to the chart
this.AmCharts.updateChart(this.chart, () => {
// Change whatever properties you want
this.chart.dataProvider = [];
});- If you want to add event listeners, use the
addListenermethod:
this.AmCharts.addListener(this.chart, "init", (e) => {
// Do stuff when the event happens
});The addListener method returns a function which you can call if you want to stop listening to the event:
const stop = this.AmCharts.addListener(this.chart, "init", (e) => {
// Do stuff when the event happens
});
// Call the stop function when you want to stop listening to the event
stop();- Rather than using
AmChartsServiceyou can instead use the<amCharts>tag in your template:
@Component({
template: `<amCharts id="chartdiv" [options]="options" [style.width.%]="100" [style.height.px]="500"></amCharts>`
})
export class AppComponent {
public options = {
"type": "serial",
"theme": "light",
"dataProvider": []
...
};
}This is much easier than using AmChartsService, but you cannot call the AmCharts methods, and it is difficult to change the chart options, so it works best for charts which do not change.
You can see some examples in the examples directory.
- Adding in support for Angular 17
- Adding in support for Angular 16
- Adding in support for Angular 15
- Adding in support for Angular 14
- Adding in support for Angular 13
- Adding in support for Angular 12 Ivy
- Upgrading to Angular 9 - 12
- Upgrading to Angular 8
- Upgrading to Angular 7
- Adding in
StockEventandStockLegendconstructors for dynamically adding stock events/legend.
- Adding in
StockPanelandStockGraphconstructors for dynamically adding stock panels/graphs.
- Adding in
addInitHandler,addPrefix,clear,formatDate,formatNumber, andstringToDatemethods toAmChartsService
- Upgrading to Angular 5
- Removing the Quickstart Seed example
- Adding in
addListenermethod
- Undeprecating the
AmChartsDirective - Adding in
delayoption forAmChartsDirective
- Adding in all of the global
AmChartsproperties to theAmChartsService
- Updating to the latest version of the Angular compiler
- Adding in support for Angular 4
- Deprecating the
<amCharts>element in favor of the newAmChartsService
- Various fixes
- Adding examples
- Initial release
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent