SoFunction
Updated on 2025-04-13

Example of method using echarts-for-react in React

In modern web development, data visualization is an important means to display complex information and enhance user experience. As one of the most well-known visual chart libraries in China, ECharts provides a rich variety of chart types and powerful customization capabilities. andecharts-for-reactThis is the official packaging component of ECharts in the React ecosystem, which allows developers to easily integrate ECharts charts in React applications. This article will explain in detail how to use it in a React projectecharts-for-react, including installation, basic usage, performance optimization and event handling.

1. Install echarts-for-react

Use in React Projectecharts-for-reactBefore, you need to install it and its dependencies firstechartslibrary. Here are the installation steps:

npm install --save echarts-for-react
npm install --save echarts

echartsyesecharts-for-reactdependencies, therefore need to be installed separately.

2. Basic usage

1. Introduce components

In React components, it can be introduced in the following waysReactECharts

import React from 'react';
import ReactECharts from 'echarts-for-react';

2. Render the chart

ReactEChartsComponent passoptionThe property receives the configuration items of ECharts. Here is a simple bar chart example:

import React from 'react';
import ReactECharts from 'echarts-for-react';

const MyChart = () => {
  const getOption = () => ({
    xAxis: {
      type: 'category',
      data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
    },
    yAxis: {
      type: 'value'
    },
    series: [
      {
        data: [820, 932, 901, 934, 1290, 1330, 1320],
        type: 'bar'
      }
    ]
  });

  return <ReactECharts option={getOption()} />;
};

export default MyChart;

3. Custom styles

Can be passedstyleorclassNameAttribute custom chart style:

<ReactECharts
  option={getOption()}
  style={{ height: '400px', width: '100%' }}
  className="my-chart"
/>

3. Performance optimization

1. Load the ECharts module on demand

To reduce the packaging volume, the required ECharts modules can be imported manually. For example, when using only the histogram and prompt box components, you can import it like this:

import React from 'react';
import ReactEChartsCore from 'echarts-for-react/lib/core';
import * as echarts from 'echarts/core';
import { BarChart } from 'echarts/charts';
import { TooltipComponent, GridComponent } from 'echarts/components';
import { CanvasRenderer } from 'echarts/renderers';

([TooltipComponent, GridComponent, BarChart, CanvasRenderer]);

const MyChart = () => {
  const getOption = () => ({
    xAxis: { type: 'category', data: ['Mon', 'Tue', 'Wed'] },
    yAxis: { type: 'value' },
    series: [{ data: [820, 932, 901], type: 'bar' }]
  });

  return (
    <ReactEChartsCore
      echarts={echarts}
      option={getOption()}
      style={{ height: '400px' }}
    />
  );
};

export default MyChart;

2. Use notMerge and lazyUpdate

When updating chart data, usenotMergeandlazyUpdateProperties can reduce unnecessary rendering:

<ReactECharts
  option={getOption()}
  notMerge={true}
  lazyUpdate={true}
/>

4. Event handling

ReactEChartsSupports events that bind ECharts. For example, listening to a graphclickevent:

const onChartClick = (params, echartsInstance) => {
  ('Chart clicked:', params);
};

const MyChart = () => {
  const getOption = () => ({
    xAxis: { type: 'category', data: ['Mon', 'Tue', 'Wed'] },
    yAxis: { type: 'value' },
    series: [{ data: [820, 932, 901], type: 'bar' }]
  });

  return (
    <ReactECharts
      option={getOption()}
      onEvents={{ 'click': onChartClick }}
    />
  );
};

export default MyChart;

5. Summary

echarts-for-reactIt is a powerful and easy to use React component that allows developers to quickly integrate ECharts charts in React applications. Through this article, you have mastered how to install, use, optimize performance, and handle events. Whether it is simple data visualization or complex interactive charts,echarts-for-reactAll can meet your needs.

If you need to know more advanced features, please refer toecharts-for-reactofOfficial DocumentationOr see more examples.

This is the end of this article about the example method of using echarts-for-react in React. For more related React echarts-for-react content, please search for my previous articles or continue browsing the related articles below. I hope everyone will support me in the future!