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

胖浩酱_6654

胖浩酱_6654

2026-01-21

992人浏览

原创

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

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

在 ECharts 中,默认图例点击行为是切换(toggle)——即点击已选图例会取消选中,导致数据项隐藏;再次点击则恢复。但许多业务场景(如聚焦分析某一项、简化图表对比)需要更严格的单选模式(radio-like behavior):点击任意图例项时,仅该数据系列显示,其余全部隐藏。

这并非 ECharts 的内置模式,但完全可通过事件 + 动作调度实现。核心思路是:

  1. 监听 legendselectchanged 事件(在用户点击图例后触发,且在图表重绘前);
  2. 在回调中主动调用 dispatchAction 执行三步操作:
    • legendAllSelect:全选所有图例项(确保后续操作有统一起点);
    • legendInverseSelect:反选(即全部取消);
    • legendSelect:仅显式选中当前点击的 params.name 对应项。

✅ 这样即可强制达成「只显示所点图例对应数据」的效果,视觉上等效于单选。

以下是完整可运行的配置示例(基于 Pie 图表):

ECharts Master
ECharts Master

ECharts 图表大师。根据用户数据和业务上下文,自动设计并生成专业的 ECharts 可视化图表。使用场景:(1) 用户提供表格/JSON/CSV 数据需要可视化,(2) 用户说"帮我做个图"、"画个图表",(3) 需要将查询结果可视化展示。

下载
import * as echarts from 'echarts';

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

myChart.on('legendselectchanged', (params) => {
  const { name } = params;
  // 强制单选:先全选 → 再全不选 → 最后只选当前项
  myChart.dispatchAction({ type: 'legendAllSelect' });
  myChart.dispatchAction({ type: 'legendInverseSelect' });
  myChart.dispatchAction({ type: 'legendSelect', name });
});

const option = {
  tooltip: { trigger: 'item' },
  legend: {
    top: '15%',
    left: '5%',
    orient: 'vertical',
    textStyle: { fontSize: 25 },
    // 启用图例选择器(可选,增强交互提示)
    selector: [{ type: 'all' }, { type: 'inverse' }]
  },
  series: [{
    type: 'pie',
    radius: ['55%', '70%'],
    avoidLabelOverlap: false,
    itemStyle: { borderRadius: 35, borderColor: '#fff', borderWidth: 8 },
    label: { show: false, position: 'center' },
    labelLine: { show: false },
    data: [
      { value: 2, name: 'LR-MS' },
      { value: 2, name: 'LR-MB-30' },
      { value: 1, name: 'LR-MS-RS485-DIN' }
    ]
  }]
};

myChart.setOption(option);

⚠️ 注意事项:

  • legendselectchanged 是响应式事件,务必在 setOption 之前注册,否则首次点击可能不触发;
  • 若图表支持多系列(如 line/bar 混合),逻辑同样适用,只需确保 series[i].name 与图例 name 严格一致;
  • 如需支持「点击已选项恢复全显」,可在回调中加判断:if (params.selected[name]) { /* 全选 */ } else { /* 单选 */ };
  • 性能敏感场景下,连续快速点击可能引发多次重绘,建议添加防抖(lodash.debounce)或节流处理。

该方案无需修改 ECharts 源码,兼容 v5.x 全版本,是实现图例驱动数据聚焦的标准实践。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

echarts 重绘

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
ECharts是什么
ECharts是什么

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

2023.08.04

892

5

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

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

2023.09.13

5005

8

Docker Desktop怎么设置端口映射
Docker Desktop怎么设置端口映射

本专题聚焦Docker Desktop容器端口映射与访问配置,整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况,也提供相应的检查方向,方便用户完成端口配置。

2026.11.03

0

18

Docker Desktop镜像构建教程
Docker Desktop镜像构建教程

想使用Docker Desktop将本地项目构建成Docker镜像?本专题围绕镜像构建的实际操作展开,介绍Dockerfile编写、构建命令使用、镜像标签设置和构建日志查看等内容,同时整理镜像无法生成、依赖安装失败及构建缓存异常等问题的排查思路。

2026.11.03

0

11

Docker Desktop容器创建指南
Docker Desktop容器创建指南

本专题聚焦Docker Desktop容器创建与运行配置,介绍通过本地镜像或远程镜像创建容器的方法,以及容器启动、终端访问、日志查看和基础管理等操作。针对端口冲突、参数配置不当、容器无法启动等情况,也整理了相应的排查方向。

2026.11.03

0

11

Tailwind CSS 如何制作导航栏和卡片
Tailwind CSS 如何制作导航栏和卡片

用 Tailwind CSS 制作导航栏和卡片,可先搭建语义化结构,再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章,帮助你把常见页面组件做得清晰且适配不同屏幕。

2026.11.03

0

17

Tailwind CSS 响应式布局怎么写
Tailwind CSS 响应式布局怎么写

Tailwind CSS 响应式布局通常从移动端样式写起,再用 sm、md、lg 等前缀调整不同屏幕宽度下的网格、间距和导航。本专题整理断点配置、Grid 与 Flex 自适应布局及常见溢出问题,帮助你逐步完成多设备适配。

2026.11.03

0

19

Tailwind CSS 常用类名怎么记
Tailwind CSS 常用类名怎么记

Tailwind CSS 类名很多,先按布局、间距、文字、颜色和状态分组记忆,再通过官方文档检索具体写法。本专题结合类名排序、动态拼接失效、自定义实用类等问题,帮助你建立常用类名的速查方法。

2026.11.03

0

12

码上飞入口地址合集
码上飞入口地址合集

本专题汇总了码上飞(CodeFlying)的官方入口地址合集,涵盖官网主站及网页版在线使用入口,支持注册登录后直接在线体验零代码AI应用生成。同时整理了APP端下载渠道与小程序入口,助你快速访问平台,通过自然语言描述需求即可生成应用、小程序或网站。

2026.11.03

0

10

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程