教程

掌握echarts图表，从入门到精通：全面教程文档大揭秘

2026-10-13 0 阅读

ECharts 是一个使用 JavaScript 实现的开源可视化库，可以轻松地在网页中添加交互式的图表。它拥有丰富的图表类型，如折线图、柱状图、饼图、散点图等，并且易于定制和扩展。本教程将从入门到精通，全面揭秘 ECharts 的使用方法。

一、ECharts 入门

1.1 ECharts 简介

ECharts 是由百度团队开发的一个强大的可视化库，支持多种图表类型和丰富的配置项。它具有以下特点：

  • 丰富的图表类型：提供折线图、柱状图、饼图、散点图、地图、雷达图、K线图等20多种图表类型。
  • 高性能：基于 Canvas 和 SVG 渲染，具有高性能和良好的兼容性。
  • 易于使用：提供简单易用的 API 和丰富的配置项，方便开发者快速上手。
  • 高度可定制：支持主题配置、样式自定义、数据动态更新等功能。

1.2 安装与引入

ECharts 支持多种引入方式，包括 CDN、npm 和直接下载。以下为通过 CDN 引入 ECharts 的示例代码：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>ECharts 示例</title>
    <!-- 引入 ECharts -->
    <script src="https://cdn.bootcdn.net/ajax/libs/echarts/5.3.3/echarts.min.js"></script>
</head>
<body>
    <!-- 准备一个用于展示图表的 DOM 元素 -->
    <div id="main" style="width: 600px;height:400px;"></div>
    <script type="text/javascript">
        // 初始化图表
        var myChart = echarts.init(document.getElementById('main'));

        // 指定图表的配置项和数据
        var option = {
            title: {
                text: 'ECharts 入门示例'
            },
            tooltip: {},
            legend: {
                data:['销量']
            },
            xAxis: {
                data: ["衬衫","羊毛衫","雪纺衫","裤子","高跟鞋","袜子"]
            },
            yAxis: {},
            series: [{
                name: '销量',
                type: 'bar',
                data: [5, 20, 36, 10, 10, 20]
            }]
        };

        // 使用刚指定的配置项和数据显示图表。
        myChart.setOption(option);
    </script>
</body>
</html>

二、ECharts 常用图表类型

2.1 折线图

折线图适用于展示数据的变化趋势。以下为一个简单的折线图示例：

var myChart = echarts.init(document.getElementById('main'));

var option = {
    title: {
        text: '折线图示例'
    },
    tooltip: {},
    legend: {
        data:['销量']
    },
    xAxis: {
        data: ["衬衫","羊毛衫","雪纺衫","裤子","高跟鞋","袜子"]
    },
    yAxis: {},
    series: [{
        name: '销量',
        type: 'line',
        data: [5, 20, 36, 10, 10, 20]
    }]
};

myChart.setOption(option);

2.2 柱状图

柱状图适用于比较不同类别的数据。以下为一个简单的柱状图示例：

var myChart = echarts.init(document.getElementById('main'));

var option = {
    title: {
        text: '柱状图示例'
    },
    tooltip: {},
    legend: {
        data:['销量']
    },
    xAxis: {
        data: ["衬衫","羊毛衫","雪纺衫","裤子","高跟鞋","袜子"]
    },
    yAxis: {},
    series: [{
        name: '销量',
        type: 'bar',
        data: [5, 20, 36, 10, 10, 20]
    }]
};

myChart.setOption(option);

2.3 饼图

饼图适用于展示各部分占总体的比例。以下为一个简单的饼图示例：

var myChart = echarts.init(document.getElementById('main'));

var option = {
    title: {
        text: '饼图示例'
    },
    tooltip: {
        trigger: 'item'
    },
    legend: {
        orient: 'vertical',
        left: 'left',
        data: ['衬衫','羊毛衫','雪纺衫','裤子','高跟鞋','袜子']
    },
    series: [
        {
            name: '销量',
            type: 'pie',
            radius: '50%',
            data: [
                {value: 5, name: '衬衫'},
                {value: 20, name: '羊毛衫'},
                {value: 36, name: '雪纺衫'},
                {value: 10, name: '裤子'},
                {value: 10, name: '高跟鞋'},
                {value: 20, name: '袜子'}
            ],
            emphasis: {
                itemStyle: {
                    shadowBlur: 10,
                    shadowOffsetX: 0,
                    shadowColor: 'rgba(0, 0, 0, 0.5)'
                }
            }
        }
    ]
};

myChart.setOption(option);

三、ECharts 高级功能

3.1 动态数据更新

ECharts 支持动态数据更新，可以实时展示数据变化。以下为一个动态更新数据的示例：

setInterval(function () {
    var data = [Math.round(Math.random() * 100)];
    myChart.setOption({
        series: [{
            data: data
        }]
    });
}, 2000);

3.2 主题配置

ECharts 提供了丰富的主题配置，可以自定义图表样式。以下为一个应用主题配置的示例：

var myChart = echarts.init(document.getElementById('main'));

// 引入自定义主题
echarts.registerTheme('customTheme', {
    color: ['#3366CC', '#DC3912', '#FF9900', '#109618', '#990099', '#3B3EAC', '#FF0000', '#00FF00', '#0000FF', '#FF00FF', '#00FFFF'],
    // 其他配置...
});

// 应用主题
myChart.setOption({
    theme: 'customTheme'
});

3.3 数据交互

ECharts 支持多种数据交互方式，如点击、悬停、拖动等。以下为一个点击交互的示例：

myChart.on('click', function (params) {
    console.log(params.name + '：' + params.value);
});

四、ECharts 实战案例

4.1 在线地图

ECharts 支持在线地图，可以展示地理位置信息。以下为一个在线地图示例：

var myChart = echarts.init(document.getElementById('main'));

var option = {
    title: {
        text: '在线地图示例'
    },
    tooltip: {
        trigger: 'item',
        formatter: '{b}<br/>{c}'
    },
    visualMap: {
        min: 0,
        max: 100,
        left: 'left',
        top: 'bottom',
        text: ['高','低'],           // 文本，默认为数值文本
        calculable: true
    },
    series: [
        {
            name: '销量',
            type: 'map',
            mapType: 'china',
            roam: true,
            label: {
                show: true
            },
            data: [
                {name: '北京',value: Math.round(Math.random() * 1000)},
                {name: '天津',value: Math.round(Math.random() * 1000)},
                // 其他城市...
            ]
        }
    ]
};

myChart.setOption(option);

4.2 K线图

K线图适用于展示股票、期货等金融数据。以下为一个 K线图示例：

var myChart = echarts.init(document.getElementById('main'));

var option = {
    title: {
        text: 'K线图示例'
    },
    tooltip: {
        trigger: 'axis',
        axisPointer: {
            type: 'cross',
            label: {
                backgroundColor: '#6a7985'
            }
        }
    },
    legend: {
        data:['日K', '成交']
    },
    xAxis: {
        type: 'category',
        data: ['2017-01-01', '2017-01-02', '2017-01-03', '2017-01-04', '2017-01-05', '2017-01-06', '2017-01-07', '2017-01-08', '2017-01-09', '2017-01-10']
    },
    yAxis: [
        {
            type: 'value',
            scale: true,
            name: '价格',
            position: 'left',
            axisLabel: {
                formatter: '{value} $
            }
        },
        {
            type: 'value',
            scale: true,
            name: '成交',
            position: 'right',
            axisLabel: {
                formatter: '{value} 万'
            }
        }
    ],
    series: [
        {
            name: '日K',
            type: 'candlestick',
            data: [
                [1.1000, 1.2000, 1.1500, 1.0800],
                [1.1500, 1.3000, 1.2500, 1.1200],
                [1.2000, 1.4000, 1.3500, 1.1800],
                [1.2500, 1.5000, 1.4500, 1.2100],
                [1.3000, 1.5500, 1.5000, 1.2600],
                [1.3500, 1.6000, 1.5500, 1.3100],
                [1.4000, 1.6500, 1.6000, 1.3500],
                [1.4500, 1.7000, 1.6500, 1.4000],
                [1.5000, 1.7500, 1.7000, 1.4500],
                [1.5500, 1.8000, 1.7500, 1.5000]
            ]
        },
        {
            name: '成交',
            type: 'line',
            yAxisIndex: 1,
            data: [120, 132, 101, 134, 90, 230, 210, 230, 240, 250]
        }
    ]
};

myChart.setOption(option);

五、总结

通过本教程的学习，相信你已经掌握了 ECharts 的基本使用方法和一些高级功能。ECharts 是一款非常优秀的可视化库，可以帮助你轻松地展示数据。在实际项目中，你可以根据自己的需求选择合适的图表类型和配置项，以实现最佳的数据可视化效果。

祝你在 ECharts 的学习道路上越走越远！

分享到：
上一篇 教你轻松掌握阿尔法机器人门控技能，从小白变达人！
下一篇 从零开始，轻松学会Android蓝牙开发：实操教程与常见问题解答