Convert Figma logo to code with AI

apexcharts logoreact-apexcharts

📊 React Component for ApexCharts

1,297
151
1,297
116

Top Related Projects

23,653

Redefined chart library built with React and D3

64,334

Simple HTML5 Charts using the <canvas> tag

108,427

Bring data to life with SVG, Canvas and HTML. :bar_chart::chart_with_upwards_trend::tada:

Highcharts JS, the JavaScript charting framework

Quick Overview

React-ApexCharts is a React wrapper for ApexCharts, a modern charting library that helps developers create interactive and responsive charts. It provides a simple and declarative way to integrate ApexCharts into React applications, allowing for easy creation of various chart types with customizable options.

Pros

  • Easy integration with React applications
  • Wide variety of chart types and customization options
  • Responsive and interactive charts out of the box
  • Good documentation and community support

Cons

  • Large bundle size due to the underlying ApexCharts library
  • Limited server-side rendering support
  • Learning curve for advanced customizations
  • Occasional performance issues with large datasets

Code Examples

  1. Basic Line Chart:
import React from 'react';
import ReactApexChart from 'react-apexcharts';

const LineChart = () => {
  const options = {
    xaxis: {
      categories: ['Jan', 'Feb', 'Mar', 'Apr', 'May']
    }
  };
  const series = [{
    name: 'Sales',
    data: [30, 40, 35, 50, 49]
  }];

  return (
    <ReactApexChart type="line" options={options} series={series} height={350} />
  );
};
  1. Customized Bar Chart:
import React from 'react';
import ReactApexChart from 'react-apexcharts';

const BarChart = () => {
  const options = {
    chart: {
      type: 'bar'
    },
    plotOptions: {
      bar: {
        horizontal: true
      }
    },
    colors: ['#008FFB', '#00E396', '#FEB019']
  };
  const series = [{
    data: [400, 430, 448]
  }];

  return (
    <ReactApexChart options={options} series={series} type="bar" height={350} />
  );
};
  1. Responsive Pie Chart:
import React from 'react';
import ReactApexChart from 'react-apexcharts';

const PieChart = () => {
  const options = {
    labels: ['Team A', 'Team B', 'Team C'],
    responsive: [{
      breakpoint: 480,
      options: {
        chart: {
          width: 200
        },
        legend: {
          position: 'bottom'
        }
      }
    }]
  };
  const series = [44, 55, 13];

  return (
    <ReactApexChart options={options} series={series} type="pie" width={380} />
  );
};

Getting Started

To use React-ApexCharts in your project, follow these steps:

  1. Install the package:
npm install react-apexcharts apexcharts
  1. Import and use the component in your React application:
import React from 'react';
import ReactApexChart from 'react-apexcharts';

const MyChart = () => {
  const options = {
    // Chart options
  };
  const series = [
    // Chart data
  ];

  return (
    <ReactApexChart options={options} series={series} type="line" height={350} />
  );
};

export default MyChart;

Make sure to customize the options and series props according to your chart requirements. Refer to the ApexCharts documentation for detailed configuration options.

Competitor Comparisons

23,653

Redefined chart library built with React and D3

Pros of Recharts

  • Built specifically for React, offering seamless integration and better performance
  • Highly customizable with a declarative API, making it easier to create complex charts
  • Smaller bundle size, which can lead to faster load times for applications

Cons of Recharts

  • Less variety of chart types compared to ApexCharts
  • Documentation can be less comprehensive, potentially leading to a steeper learning curve
  • May require more custom code for advanced features that come built-in with ApexCharts

Code Comparison

Recharts:

import { LineChart, Line, XAxis, YAxis, CartesianGrid, Tooltip, Legend } from 'recharts';

<LineChart width={600} height={300} data={data}>
  <Line type="monotone" dataKey="value" stroke="#8884d8" />
  <CartesianGrid stroke="#ccc" />
  <XAxis dataKey="name" />
  <YAxis />
  <Tooltip />
</LineChart>

ApexCharts:

import Chart from 'react-apexcharts'

<Chart
  options={{
    chart: { id: 'basic-line' },
    xaxis: { categories: data.map(d => d.name) }
  }}
  series={[{ name: 'series-1', data: data.map(d => d.value) }]}
  type="line"
  width={600}
  height={300}
/>

Both libraries offer React-friendly APIs, but Recharts tends to be more declarative, while ApexCharts provides a more configuration-based approach.

64,334

Simple HTML5 Charts using the <canvas> tag

Pros of Chart.js

  • Lightweight and fast, with a smaller bundle size
  • Extensive documentation and large community support
  • More flexible for custom chart types and animations

Cons of Chart.js

  • Less out-of-the-box chart types compared to react-apexcharts
  • Requires more manual configuration for advanced features
  • Not specifically designed for React, may need additional wrappers

Code Comparison

Chart.js:

import { Chart } from 'chart.js/auto';

new Chart(ctx, {
    type: 'bar',
    data: chartData,
    options: chartOptions
});

react-apexcharts:

import ReactApexChart from 'react-apexcharts';

<ReactApexChart
    options={chartOptions}
    series={chartData}
    type="bar"
    height={350}
/>

Chart.js is a versatile and lightweight charting library that offers flexibility and extensive customization options. It has a larger community and more comprehensive documentation, making it easier to find solutions and examples. However, it requires more manual configuration for advanced features and isn't specifically designed for React applications.

react-apexcharts, on the other hand, is tailored for React and provides more out-of-the-box chart types and features. It offers a simpler API for React developers but may have a larger bundle size and less flexibility for highly custom chart types.

The choice between the two depends on specific project requirements, desired level of customization, and the developer's familiarity with React ecosystem.

108,427

Bring data to life with SVG, Canvas and HTML. :bar_chart::chart_with_upwards_trend::tada:

Pros of d3

  • Highly flexible and customizable, allowing for complex and unique visualizations
  • Extensive library with a wide range of chart types and data manipulation tools
  • Large community and ecosystem with numerous extensions and resources

Cons of d3

  • Steeper learning curve, requiring more time and effort to master
  • More verbose code, often requiring more lines to create basic charts
  • Less out-of-the-box responsiveness, requiring additional work for mobile-friendly designs

Code Comparison

d3:

const svg = d3.select("body").append("svg")
    .attr("width", 400)
    .attr("height", 300);

svg.selectAll("rect")
    .data(data)
    .enter()
    .append("rect")
    .attr("x", (d, i) => i * 70)
    .attr("y", (d, i) => 300 - 10 * d)
    .attr("width", 65)
    .attr("height", (d, i) => d * 10);

react-apexcharts:

<ReactApexChart
  options={{
    chart: { type: 'bar' },
    xaxis: { categories: ['A', 'B', 'C', 'D', 'E'] }
  }}
  series={[{ data: [30, 40, 35, 50, 49] }]}
  type="bar"
  height={350}
/>

Highcharts JS, the JavaScript charting framework

Pros of Highcharts

  • More extensive chart types and features
  • Better documentation and community support
  • Robust export functionality for various formats

Cons of Highcharts

  • Commercial license required for most use cases
  • Steeper learning curve due to more complex API
  • Larger file size, potentially impacting load times

Code Comparison

Highcharts:

Highcharts.chart('container', {
  chart: { type: 'line' },
  series: [{ data: [1, 2, 3, 4, 5] }]
});

React-ApexCharts:

<ApexCharts
  options={{ chart: { type: 'line' } }}
  series={[{ data: [1, 2, 3, 4, 5] }]}
/>

Summary

Highcharts offers a more comprehensive charting solution with extensive features and better documentation, but comes with a commercial license requirement and a steeper learning curve. React-ApexCharts, on the other hand, provides a simpler API and is free for commercial use, but may lack some advanced features found in Highcharts. The code comparison shows that both libraries have relatively straightforward implementations, with React-ApexCharts using a more React-friendly component approach.

Convert Figma logo designs to code with AI

Visual Copilot

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

License build ver

React.js wrapper for ApexCharts to build interactive visualizations in react.

Download and Installation

Installing via npm
npm install react-apexcharts apexcharts

Usage

import Chart from 'react-apexcharts'

To create a basic bar chart with minimal configuration, write as follows:

class App extends Component {
  constructor(props) {
    super(props);

    this.state = {
      options: {
        chart: {
          id: 'apexchart-example'
        },
        xaxis: {
          categories: [1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999]
        }
      },
      series: [{
        name: 'series-1',
        data: [30, 40, 35, 50, 49, 60, 70, 91, 125]
      }]
    }
  }
  render() {
    return (
      <Chart options={this.state.options} series={this.state.series} type="bar" width={500} height={320} />
    )
  }
}

This will render the following chart

How do I update the chart?

Simple! Just change the series or any option and it will automatically re-render the chart.

View this example on codesandbox

Important: While updating the options, make sure to update the outermost property even when you need to update the nested property.

✅ Do this

this.setState({
  options: {
    ...this.state.options,
    xaxis: {
      ...this.state.options.xaxis,
      categories: ['X1', 'X2', 'X3']
    }
  }
})

❌ Not this

this.setState({
  options.xaxis.categories: ['X1', 'X2', 'X3']
})

Props

PropTypeDescription
seriesArrayThe series is a set of data. To know more about the format of the data, checkout Series docs on the website.
typeStringline, area, bar, pie, donut, scatter, bubble, heatmap, radialBar
widthNumber or StringPossible values for width can be 100%, 400px or 400 (by default is 100%)
heightNumber or StringPossible values for height can be 100%, 300px or 300 (by default is auto)
optionsObjectThe configuration object, see options on API (Reference)

How to call methods of ApexCharts programmatically?

Sometimes, you may want to call other methods of the core ApexCharts library, and you can do so on ApexCharts global variable directly

Example

ApexCharts.exec('reactchart-example', 'updateSeries', [{
  data: [40, 55, 65, 11, 23, 44, 54, 33]
}])

More info on the .exec() method can be found here

All other methods of ApexCharts can be called this way

What's included

The repository includes the following files and directories.

react-apexcharts/
├── dist/
│   ├── react-apexcharts.min.js
│   └── react-apexcharts.js
└── example/
│   ├── src/
│   ├── public/
│   ├── package.json
│   └── README.md
└── src/
    └── react-apexcharts.jsx

Development

Install dependencies

npm install

Running the example

Basic example including update is included to show how to get started using ApexCharts with React easily.

To run the examples,

cd example
npm install
npm run start

Bundling

To build for Development
npm run dev-build
To build for Production
npm run build

License

React-ApexCharts is released under MIT license. You are free to use, modify and distribute this software, as long as the copyright header is left intact.

NPM DownloadsLast 30 Days