Skip to content

AG Charts is a fully-featured and highly customizable JavaScript charting library. The professional choice for developers building enterprise applications

License

Notifications You must be signed in to change notification settings

ag-grid/ag-charts

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

JavaScript Charting Library

AG Charts Logo
GitHub Release NPM Downloads GitHub Repo stars GitHub forks

Quality Gate Status npms.io Maintenance Score GitHub commit activity Dependents (via libraries.io?style=for-the-badge)

AG Charts is a fully-featured and highly customizable canvas-based JavaScript Charting library. It delivers outstanding performance, has no third-party dependencies, and comes with support for React Logo React , Angular Logo Angular and Vue Logo Vue .


Preview of AG Charts JavaScript Charting Examples

📖 Overview

Table of Contents

AG Charts is available in two versions: Community & Enterprise.

Features & Chart Types

Chart Types

AG Charts offers 20+ JavaScript Chart types, each of which are fully customisable:

Chart Type AG Charts Community AG Charts Enterprise
Bar
Line
Area
Scatter
Bubble
Pie
Donut
Combination
Box Plot
Candlestick
OHLC
Heatmap
Histogram
Nightingale
Radar Line
Radar Area
Radial Column
Radial Bar
Range Area
Range Bar
Sunburst
Treemap
Waterfall
Sankey
Chord

Features

AG Charts JavaScript Charting Library comes with every feature you'd expect:

Feature AG Charts Community AG Charts Enterprise
Accessibility
Localisation
Series Highlighting
Tooltips
Animations
Context Menu
Crosshairs
Navigator
Synchronization
Zoom

ℹ️ Note:

Visit the Pricing page for a full comparison.

Financial Charts

Build interactive financial charts featuring advanced annotations with minimal configuration, all you need to do is provide your data:

const options = {
    data: getData(),
};

AgCharts.createFinancialChart(options);

Once created, users will have a Financial Chart that they can interact with and add annotations to.

Financial Charts Annotations

The default chart type is Candlestick, with additional types like OHLC and Line for versatile data visualisation.


Static Badge

Maps

The Maps Series let you visualise geographic data in different ways.

Preview of Map Charts from AG Charts

Maps can display data using Shapes, Lines and Marker series:

const options = {
    topology: topology,
    series: [
        {
            type: 'map-shape',
            data: pacific,
            idKey: 'name',
            title: 'Pacific',
        },
        // ...
    ],
    legend: {
        enabled: true,
    },
    // ...
};
Static Badge

⚡️ Quick Start

AG Charts are easy to set up - all you need to do is provide your data and series type along with any other chart options. Read on for vanilla JavaScript installation instructions, or refer to our framework-specific guides for React Logo React, Angular Logo Angular and Vue Logo Vue.

Installation

$ npm install ag-charts-community

Setup

  1. Provide a Container
<!doctype html>
<html lang="en">
    <head>
        <title>AG Charts Quick Start</title>
        <!-- JavaScript Charts Core Library -->
        <script src="https://cdn.jsdelivr.net/npm/ag-charts-community/dist/umd/ag-charts-community.js"></script>
    </head>
    <body>
        <!-- Container for Chart -->
        <div id="myChart"></div>
        <!-- Charts configuration file -->
        <script src="index.js"></script>
    </body>
</html>
  1. Instantiate the JavaScript Chart
// Chart Options
const options = {};

// Create Chart
const chart = agCharts.AgCharts.create(options);
  1. Define Chart Data and Series
// Chart Options
const options = {
    // Container: HTML Element to hold the chart
    container: document.getElementById('myChart'),
    // Data: Data to be displayed in the chart
    data: [
        { month: 'Jan', avgTemp: 2.3, iceCreamSales: 162000 },
        { month: 'Mar', avgTemp: 6.3, iceCreamSales: 302000 },
        { month: 'May', avgTemp: 16.2, iceCreamSales: 800000 },
        { month: 'Jul', avgTemp: 22.8, iceCreamSales: 1254000 },
        { month: 'Sep', avgTemp: 14.5, iceCreamSales: 950000 },
        { month: 'Nov', avgTemp: 8.9, iceCreamSales: 200000 },
    ],
    // Series: Defines which chart type and data to use
    series: [{ type: 'bar', xKey: 'month', yKey: 'iceCreamSales' }],
};

ℹ️ Note:

For more information on building JavaScript Charts with AG Charts, refer to our Documentation.

🤝 Support

Enterprise Support

AG Charts Enterprise customers have access to dedicated support via ZenDesk, which is monitored by our support & engineering teams.

Bug Reports

If you have found a bug, please report it in this repository's issues section.

GitHub Issues

Questions

Look for similar problems on StackOverflow using the ag-charts tag. If nothing seems related, post a new message there. Please do not use GitHub issues to ask questions.

Stack Exchange questions

Contributing

AG Charts is developed by a team of co-located developers in London. If you want to join the team send your application to info@ag-grid.com.

⚠️ License

ag-charts-community is licensed under the MIT license.

ag-charts-enterprise has a Commercial license.

See the LICENSE file for more info.

AG ChartsLogoAG Grid

AG Grid is our flagship product, a fully-featured and highly customizable JavaScript Data Grid. It delivers outstanding performance, has no third-party dependencies and comes with support for React Logo React, Angular Logo Angular and Vue Logo Vue.

AG Charts is used within AG Grid to power the Integrated Charting feature.

Learn more at ag-grid.com


Follow us to keep up to date with all the latest news from AG Grid:

Twitter Badge LinkedIn Badge YouTube Badge Blog Badge