0

0

ECharts 实现图例单选模式:点击图例仅显示对应数据系列

花韻仙語

花韻仙語

发布时间:2026-01-21 12:42:09

|

728人浏览过

|

来源于php中文网

原创

ECharts 实现图例单选模式:点击图例仅显示对应数据系列

通过监听 `legendselectchanged` 事件并结合 `dispatchaction` 动态控制图例选中状态,可实现“点击任一图例项时,自动取消其他项选中,仅保留当前项可见”的交互效果。

在 ECharts 中,默认的图例(legend)行为是多选切换(即点击图例项可单独显示/隐藏对应系列),但有时业务需要更严格的单选模式:用户点击某个图例项后,图表应仅显示该系列,其余全部隐藏,且图例自身也同步更新为仅该项被选中。这并非 ECharts 的内置模式,但完全可通过事件 + 动作 API 灵活实现。

核心思路如下:

  • 监听 legendselectchanged 事件,捕获用户点击的图例项名称(params.name);
  • 调用 dispatchAction 执行三步操作:
    1. legendAllSelect:先全选所有图例项(确保后续操作有统一起点);
    2. legendInverseSelect:反选(即取消全部选中);
    3. legendSelect:仅手动选中当前点击项。

该流程可确保无论原始状态如何,最终只保留目标系列可见,其他系列被隐藏(series[i].show = false 效果等效)。

以下是完整可运行的配置示例(适用于饼图、柱状图、折线图等所有支持图例的图表类型):

VWO
VWO

一个A/B测试工具

下载
myChart.on('legendselectchanged', function (params) {
  const name = params.name;
  // 清空所有选中 → 仅保留当前项
  myChart.dispatchAction({ type: 'legendAllSelect' });
  myChart.dispatchAction({ type: 'legendInverseSelect' });
  myChart.dispatchAction({ type: 'legendSelect', name });
});

⚠️ 注意事项:

  • 必须在 setOption 之前绑定事件,否则首次渲染后事件可能未生效;
  • 若图例配置中启用了 selector: [{ type: 'all' }](如示例所示),需确保其与动作逻辑兼容;实际项目中可省略该配置,因 dispatchAction 已完全接管控制权;
  • 对于含多个 series 的复杂图表,建议在 legend.data 中显式声明所有图例项名称,确保 name 匹配准确;
  • 如需支持「再次点击已选项恢复全显」,可在事件回调中判断 params.selected[name] 当前状态,做条件分支处理(本例为纯单选,不包含此逻辑)。

最终效果:点击任意图例项,图表立即聚焦展示该数据系列,其余系列淡出,图例项也同步高亮唯一激活态——真正实现专业级数据聚焦交互。

相关专题

更多
ECharts是什么
ECharts是什么

ECharts是基于JavaScript的开源可视化库,能够帮助开发者轻松地实现各种复杂的数据可视化效果,提供了丰富的图表类型和交互功能。本专题为大家提供ECharts是什么的相关的文章、下载、课程内容,供大家免费下载体验。

271

2023.08.04

echarts自适应大小设置
echarts自适应大小设置

使用ECharts的自适应大小设置可以使图表能够根据不同屏幕尺寸和设备进行自适应。一种是使用resize事件,在图表容器大小改变时重新渲染图表;另一种是使用CSS样式,通过设置图表容器的宽度和高度为百分比值,使图表容器根据父元素的大小进行自适应。根据实际需求选择合适的方法,可以使图表在不同设备上都能够良好地显示和交互 。

459

2023.09.13

Java编译相关教程合集
Java编译相关教程合集

本专题整合了Java编译相关教程,阅读专题下面的文章了解更多详细内容。

9

2026.01.21

C++多线程相关合集
C++多线程相关合集

本专题整合了C++多线程相关教程,阅读专题下面的的文章了解更多详细内容。

3

2026.01.21

无人机驾驶证报考 uom民用无人机综合管理平台官网
无人机驾驶证报考 uom民用无人机综合管理平台官网

无人机驾驶证(CAAC执照)报考需年满16周岁,初中以上学历,身体健康(矫正视力1.0以上,无严重疾病),且无犯罪记录。个人需通过民航局授权的训练机构报名,经理论(法规、原理)、模拟飞行、实操(GPS/姿态模式)及地面站训练后考试合格,通常15-25天拿证。

14

2026.01.21

Python多线程合集
Python多线程合集

本专题整合了Python多线程相关教程,阅读专题下面的文章了解更多详细内容。

1

2026.01.21

java多线程相关教程合集
java多线程相关教程合集

本专题整合了java多线程相关教程,阅读专题下面的文章了解更多详细内容。

3

2026.01.21

windows激活码分享 windows一键激活教程指南
windows激活码分享 windows一键激活教程指南

Windows 10/11一键激活可以通过PowerShell脚本或KMS工具实现永久或长期激活。最推荐的简便方法是打开PowerShell(管理员),运行 irm https://get.activated.win | iex 脚本,按提示选择数字激活(选项1)。其他方法包括使用HEU KMS Activator工具进行智能激活。

2

2026.01.21

excel表格操作技巧大全 表格制作excel教程
excel表格操作技巧大全 表格制作excel教程

Excel表格操作的核心技巧在于 熟练使用快捷键、数据处理函数及视图工具,如Ctrl+C/V(复制粘贴)、Alt+=(自动求和)、条件格式、数据验证及数据透视表。掌握这些可大幅提升数据分析与办公效率,实现快速录入、查找、筛选和汇总。

6

2026.01.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号