highcharts-ng
Advanced tools
AngularJS directive for Highcharts
A simple Angularjs directive for Highcharts.
Setup:
Install with bower/npm:
bower install highcharts-ng
Add references to Highcharts/Highstocks:
<script src="http://code.highcharts.com/stock/highstock.src.js"></script>
or
<script src="http://code.highcharts.com/highcharts.src.js"></script>
(optional) If you don't include jQuery in your page, you have to use Highcharts' Standalone Adapter (else, it will not work):
<script src="http://code.highcharts.com/adapters/standalone-framework.js"></script>
Add Highcharts to your Angular app config:
var myapp = angular.module('myapp', ["highcharts-ng"]);
Make a chart!
<highchart id="chart1" config="chartConfig"></highchart>
The chartConfig attribute mentioned above resembles an exploded highcharts options object:
var chartConfig = {
//This is not a highcharts object. It just looks a little like one!
options: {
//This is the Main Highcharts chart config. Any Highchart options are valid here.
//will be ovverriden by values specified below.
chart: {
type: 'bar'
},
tooltip: {
style: {
padding: 10,
fontWeight: 'bold'
}
}
},
//The below properties are watched separately for changes.
//Series object (optional) - a list of series using normal highcharts series options.
series: [{
data: [10, 15, 12, 8, 7]
}],
//Title configuration (optional)
title: {
text: 'Hello'
},
//Boolean to control showng loading status on chart (optional)
//Could be a string if you want to show specific loading text.
loading: false,
//Configuration for the xAxis (optional). Currently only one x axis can be dynamically controlled.
//properties currentMin and currentMax provied 2-way binding to the chart's maximimum and minimum
xAxis: {
currentMin: 0,
currentMax: 20,
title: {text: 'values'}
},
//Whether to use HighStocks instead of HighCharts (optional). Defaults to false.
useHighStocks: false,
//size (optional) if left out the chart will default to size of the div or something sensible.
size: {
width: 400,
height: 300
},
//function (optional)
func: function (chart) {
//setup some logic for the chart
}
};
All properties on the chart configuration are optional. If you don't need a feature best to leave it out completely - Highcharts will usually default to something sensible. Each property is watched for changes by angularjs. NOTE: A common error is to put other highcharts options directly into the chartConfig. In general if the highcharts option you want isn't listed above you probably want to put it in chartConfig.options
The Highcharts object can be accessed with chartConfig.getHighcharts(). This is a simple way to access all the Highcharts API that is not currently managed by this directive. See the JSFiddle basic example to see how this is used to call the print function of Highcharts.
At least half of all issues filed are due to this. Before you file an issue read this! A common error is to put other highcharts options directly into the chartConfig. In general if the highcharts option you want isn't listed above you probably want to put it in chartConfig.options.
From version 0.0.8 onwards you can use config.getHighcharts. 95% of the time you won't need this and should instead change the chartConfig instead.
Be careful - if you manually change something with the chart object that is also in the chartConfig the chart and the config may end up out of sync.
Lets consider the below snippet.
$scope.chartConfig = {
options: {...}, //highcharts options - using standard highcharts config
//other "dynamic" options
title: {...}
series [...]
}
In the chartConfig object above the options property is a standard highcharts options object. e.g. anything you can pass into ````new Highcharts.Chart(options);``` works here.
This options object is watched for changes. When something changes here the whole chart is recreated.
The other dynamic properties are ones that we can change without affecting the whole chart - using the api at http://api.highcharts.com/highcharts#Chart e.g. if you change the title we can call chart.setTitle and not have to recreate the whole chart. Splitting them out from the main options object means we can watch them separately.
So anything that has an api to change is declared outside the main options object.
Hope this makes sense!
<highchart id="chart1" series="chart.series" title="chart.title" options="chart.options"></highchart>
See an example here: http://jsfiddle.net/pablojim/46rhz/
FAQs
highcharts-ng
The npm package highcharts-ng receives a total of 6,843 weekly downloads. As such, highcharts-ng popularity was classified as popular.
We found that highcharts-ng demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.