npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

ag-charts-react

v10.3.1

Published

AG Charts React Component

Downloads

140,098

Readme

React Charting Library

📖 Overview

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

Features & Chart Types

Chart Types

AG Charts offers 20+ React 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 | ❌ | ✅ | | Bullet | ❌ | ✅ | | 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 React 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 | ❌ | ✅ |

Financial Charts

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

const [options, setOptions] = useState({
    data: getData(),
});

return <AgFinancialCharts options={options} />;

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

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


Maps

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

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,
    },
    // ...
};

⚡️ 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.

Installation

$ npm install ag-charts-react

Setup

  1. Import the React Chart
import React, { useState } from 'react';
import ReactDOM from 'react-dom/client';

// React Chart Component
import { AgCharts } from 'ag-charts-react';
  1. Define Chart Data and Series
const ChartExample = () => {
    // Chart Options: Control & configure the chart
    const [chartOptions, setChartOptions] = useState({
        // 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' }],
    });

    // ...
};
  1. React Chart Component

Replace your index.js file (or root component) with the following code:

// React Chart Component
  return (
    // AgCharts component with options passed as prop
    <AgCharts options={chartOptions} />
  );
}

// Render component inside root element
const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(<ChartExample />);

🤝 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.

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.

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 [email protected].

⚠️ 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 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: