Skip to content

arbisoft/tc-angular-chartjs

 
 

Repository files navigation

tc-angular-chartjs

Build Status

Documentation

Add Chart.js to your angular applications

tc-angular-chartjs provides you with directives for all chartjs chart types.

  • Line Charts
  • Bar Charts
  • Radar Charts
  • Polar Area Charts
  • Pie Charts
  • Doughnut Charts

You can see all the Chart.js Documentation on their website.

Installation

Grab the latest version of Chart.js and tc-angular-chartjs.

Load Chart.js and tc-angular-chartjs as you would with normal scripts.

<script type="text/javascript" src="js/Chart.js"></script>
<script type="text/javascript" src="js/angular.js"></script>
<script type="text/javascript" src="js/tc-angular-chartjs.js"></script>

Make sure you use dist/tc-angular-chartjs.js or dist/tc-angular-chartjs.min.js

Require tc.chartjs in your application modules where you require Chart.js.

angular.module( 'app', ['tc.chartjs']);

Basic Usage

There are 6 different directives.

  • tc-chartjs
  • tc-chartjs-line
  • tc-chartjs-bar
  • tc-chartjs-radar
  • tc-chartjs-polararea
  • tc-chartjs-pie
  • tc-chartjs-doughnut

Just place one of these directives on a canvas element to create a Chart.js chart.

<canvas tc-chartjs-doughnut width="350" height="350"></canvas>

You will also want to give the chart some data and options. These can be provided by assigning $scope variables to chart-options and chart-data attributes on the same canvas element.

<canvas tc-chartjs-doughnut chart-data="myData" chart-options="myOptions" chart-click="onChartClick(data, event)" width="350" height="350"></canvas>
$scope.myData = [
  { value : 50, color : "#F7464A" },
  { value : 90, color : "#E2EAE9" },
  { value : 75, color : "#D4CCC5" },
  { value : 30, color : "#949FB1"}
];

$scope.myOptions =  {
  // Chart.js options can go here.
};

$scope.onChartClick = function (data, event) {
  console.log(data, event);
};

Using the tc-chartjs directive

When using the tc-chartjs directive you will need to add an additional attribute to say which type of chart should be created.

Just attach a chart-type="" attribute to the canvas element.

<canvas tc-chartjs chart-type="doughnut" chart-data="data" chart-options="options" width="350" height="350"></canvas>

Available Types:

  • line
  • bar
  • radar
  • polararea
  • pie
  • doughnut

Passing another value to chart-type than the above will try to create a chart of that type, which is useful if you have extended Chart.js with custom chart types, e.g. through plugins.

Contributing

  • Open a Pull Request (PR)
  • Make sure your PR is on a new branch you created from the latest version of master branch
  • Please do not open a PR from your master branch
  • Open a PR even if your code is incomplete to start a discussion and to collect feedback
  • Please make sure all unit tests pass, and add new tests for any added features.

License

tc-angular-chartjs is dual licensed with the Apache-2.0 or MIT license.

See LICENSE-APACHE-2.0 and LICENSE-MIT for more details.

Packages

No packages published

Languages

  • JavaScript 100.0%