Chart.js是一个流行的JavaScript图表库，ng2图表是Angular 2+的包装器，可以轻松地将Chart.js集成到Angular中。 我们来看看基本用法。

安装

首先，在项目中安装 Chart.js 和 ng2-charts:

# Yarn:
$ yarn add ng2-charts chart.js

# or npm 
$ npm install ng2-charts charts.js --save

当然 ，如果你是使用Angular CLI构建的项目，你也可以很容易的添加Chart.js 添加.angular-cli.json配置文件中，以便将它与应用绑定在一直：

//: .angular-cli.json (partial)
"script": [
  "../node_modules/chart.js/dist/Chart.min.js"
]

现在，你需要在你的 app 模块或功能模块导入 ng2-charts 的ChartsModule:

//: app.module.ts

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { ChartsModule } from '@angular/charts';

import { AppComponent } from './app.component';

@NgModule({
  declarations: [ AppComponent ],imports: [
    BrowserModule,ChartsModule
  ],providers: [],bootstrap: [ AppComponent ]
})
export class AppModule {}

使用

ng2-charts 给我们提供了一个可以应用于HTML canvas元素的baseChart指令。 以下是一个示例，其中显示了一些用于输入的选项以及该指令输出的chartClick事件：

//: app.component.html

<div style="width: 40%;">
  <canvas
      baseChart
      [chartType]="'line'"
      [datasets]="chartData"
      [labels]="chartLabels"
      [options]="chartOptions"
      [legend]="true"
      (chartClick)="onChartClick($event)">
  </canvas>
</div>

这就是组件类现在的样子：

//: app.component.ts

import { Component } from '@angular/core';

@Component({ ... })
export class AppComponent {
  chartOptions = {
    responsive: true
  };

  chartData = [
    { data: [330,600,260,700],label: 'Account A' },{ data: [120,455,100,340],label: 'Account B' },{ data: [45,67,800,500],label: 'Account C' }
  ];

  chartLabels = ['January','February','Mars','April'];

  onChartClick(event) {
    console.log(event);
  }
}

选项

以下就是不同的可选输入项：

chartType

设置图表的基本类型,值可以是pipe，doughnut，bar，line，polarArea，radar或horizontalBar。

legend

一个布尔值，用于是否在图表上方显示图例。

datasets

包含数据数组和每个数据集标签的对象数组。

data

如果你的图表很简单，只有一个数据集，你可以使用data而不是datasets。

labels

x轴的标签集合

options

包含图表选项的对象。 有关可用选项的详细信息，请参阅官方Chart.js文档。

在上面的例子中，我们将图表设置为自适应模式，根据视口大小进行自动调整。

colors

在上面的例子中未显示，但你可以定义自己的颜色， 传入包含以下值的对象文字数组：

myColors = [
  {
    backgroundColor: 'rgba(103,58,183,.1)',borderColor: 'rgb(103,183)',pointBackgroundColor: 'rgb(103,pointBorderColor: '#fff',pointHoverBackgroundColor: '#fff',pointHoverBorderColor: 'rgba(103,.8)'
  },// ...colors for additional data sets
];

使用自定义颜色时，必须为每个数据集提供一个颜色对象字面量。

事件

发出两个事件，chartClick和chartHover，它们允许对与图表交互的用户做出反应。 当前活动点和标签作为发射事件数据的一部分返回。

动态更新数据集

当然，Chart.js的优点在于，您的图表可以轻松地通过动态更新/响应从后端或用户输入的数据。

下面这个示例中，我们为5月份添加了一个新的数据集合：

//: app.component.ts(partial)

newDataPoint(dataArr = [100,100],label) {

  this.chartData.forEach((dataset,index) => {
    this.chartData[index] = Object.assign({},this.chartData[index],{
      data: [...this.chartData[index].data,dataArr[index]]
    });
  });

  this.chartLabels = [...this.chartLabels,label];

}

它可以像这样使用：

//: app.component.html(partial)

<button (click)="newDataPoint([900,50,300],'May')">
  Add data point
</button>

你可能注意到了，我们不会对图表的数据集进行改动，而是使用新数据返回包含先前数据的新对象。 Object.assign可以很容易地做到这一点。

在这个特定的例子中，如果没有提供参数时，我们为3个数据集设定了默认值为100。

天之骄子

2017.8.17 星期四 深圳