echarts的legend——图例样式的配置

🙂博主：小猫娃来啦

🙂文章核心：echarts的legend——图例样式的配置

文章目录

认识图例

从echarts官网开始了解

Legend的作用

配置Legend

图例类型

事件与交互

使用示例和Demo

真实项目中legend的配置

重点

 关于legend的所有配置项列表

---

认识图例

以下是真实项目中的图表展示以及echarts官网的图表，先看看到底什么是图例

 

以上几张图表中，红色圆圈部分即图例

echarts图表中的图例，有形状，颜色，位置等等各种样式的不同配置。

---

从echarts官网开始了解

echarts官网配置项手册里有非常详细的内容，我们挑几种常用的看看，加深对legend属性的理解

Legend的作用

• 通过Legend可以展示不同系列数据的标识符号，如颜色、线型等。
• 用户可以通过点击Legend中的项来显示或隐藏相应的系列数据。

配置Legend

• ECharts提供了丰富的配置选项，可根据需求自定义Legend的样式、位置和布局方式。
• 可以设置Legend的显示位置，如顶部、底部、左侧、右侧等。
• 可以调整Legend的大小、间距和对齐方式。
• 可以修改Legend的文本样式、背景色等。

图例类型

• ECharts支持多种图例类型，如普通图例（plain）、滚动图例（scroll）、翻页图例（paging）等。
• 普通图例适用于数据较少时，通过分页或滚动图例可适应大量数据的展示。

事件与交互

• ECharts中的图例支持事件响应，如鼠标悬停、点击等。
• 用户可以通过事件处理函数进行特定操作，如联动其他图表、自定义交互行为等。

使用示例和Demo

• 官网提供了详细的使用示例和代码，在线演示页面展示了各种不同类型的图例配置效果。
• 用户可以参考官方文档和示例进行灵活运用，满足自己的需求。
• echarts官网传送门：echarts官网

真实项目中legend的配置

option = {
    
    legend: {
        data: ['图例一', '图例二'],      //图例名称
        right: 10,                              //调整图例位置
        top: 0,                                  //调整图例位置
        itemHeight: 7,                      //修改icon图形大小
        icon: 'circle',                         //图例前面的图标形状
        textStyle: {                            //图例文字的样式
            color: '#a1a1a1',               //图例文字颜色
            fontSize: 12                      //图例文字大小
        }，

    series: [{
            name: '图例一',
            },
            {
            name: '图例二',
            }]
}

重点

• 图例data的值必须与series里的name值对应
• icon可选样式：'circle', 'rect', 'roundRect', 'triangle', 'diamond', 'pin', 'arrow', 'none'

---

关于legend的所有配置项列表

1. show: 是否显示图例，默认值为true。

2. type: 图例的类型，可选值有：

   1. 'plain'：普通图例，适用于数据较少时；
   2. 'scroll'：滚动图例，适用于大量数据的展示；
   3. 'paging'：翻页图例，适用于大量数据的展示。

3. textStyle: 图例文本的样式配置项。

   • color: 图例文本的颜色，默认为'#333'。
   • fontStyle: 图例文本的字体风格，如'normal'、'italic'、'oblique'。
   • fontWeight: 图例文本的字体粗细，如'normal'、'bold'、'bolder'、'lighter'。
   • fontSize: 图例文本的字体大小，默认为12。
   • fontFamily: 图例文本的字体系列。

4. data: 图例的数据数组，每一项对应一个系列的名称。可以通过在data中设置特殊字符来实现自定义图例标记。

5. formatter: 图例文本的格式化函数，用于自定义图例文本的显示方式。

6. selected: 图例的初始选中状态，可以通过配置该项来设置哪些系列初始时显示，哪些系列初始时隐藏。

7. inactiveColor: 未选中图例项的颜色，默认为'#ccc'。

8. selectedMode: 图例选择的模式，可选值有：

   • 'single'：单选模式，同一时刻只能选择一个图例项；
   • 'multiple'：多选模式，可以同时选择多个图例项。

9. align: 图例的水平对齐方式，默认为'auto'。

   • 'auto'：自动根据图表位置进行对齐；
   • 'left'：左对齐；
   • 'right'：右对齐。

10. verticalAlign: 图例的垂直对齐方式，默认为'auto'。

    • 'auto'：自动根据图表位置进行对齐；
    • 'top'：上对齐；
    • 'bottom'：下对齐。

11. layout: 图例的布局方式，可选值有：

    • 'horizontal'：水平布局，默认；
    • 'vertical'：垂直布局。

12. itemWidth: 图例标记的宽度，默认为25。

13. itemHeight: 图例标记的高度，默认为14。

14. itemGap: 图例项之间的间距，默认为10。

15. pageButtonItemGap: 滚动图例翻页按钮与图例项之间的间距，默认为5。

16. pageButtonGap: 滚动图例翻页按钮之间的间距，默认为0。

17. pageTextStyle: 滚动图例中页信息的样式配置项。

18. animationDurationUpdate: 图例切换时的动画时长，默认为300毫秒。

---