求react-plotly.js事件处理示例:实现双图表图例双击联动
react-plotly.js 多图表图例同步交互实现方案
针对需要实现多图表同步响应图例双击、跨图表仅展示匹配图例数据的场景,完全可以依托组件本身暴露的事件能力结合React状态共享实现,无额外框架依赖门槛,以下是可直接上手的实践逻辑和最小示例:
核心实现原理
- 组件本身透传了plotly.js原生的
plotly_legenddoubleclick事件,对应绑定在Plot组件上的属性为onLegendDoubleClick,触发时回调会返回当前被双击的图例对应轨迹的基础信息(包含轨迹名称、当前可见状态等) - 放弃依赖plotly原生的图例内置交互逻辑,改用React层的全局共享状态存储当前被选中的图例名称,所有同组图表的可见性配置都由这个共享状态驱动更新
- 当任意一张图的图例被双击时,同步更新全局选中状态,两张图接收到状态变更后,自动调整所有轨迹的
visible属性:匹配当前选中图例名称的轨迹设为正常展示,其余轨迹设为legendonly(图例保留可见、对应数据隐藏),实现双击单图例后全组图表仅展示该图例数据的效果
可直接复用的最小可运行代码示例
import { useCallback, useState } from 'react'; import Plot from 'react-plotly.js'; // 两张图各自的基础轨迹配置 const baseChart1Data = [ { name: '月度销售额', x: [1,2,3,4], y: [120, 180, 210, 250], type: 'bar' }, { name: '月度利润额', x: [1,2,3,4], y: [30, 50, 62, 80], type: 'bar' } ]; const baseChart2Data = [ { name: '月度销售额', x: [1,2,3,4], y: [130, 190, 220, 270], type: 'line' }, { name: '月度利润额', x: [1,2,3,4], y: [35, 55, 68, 85], type: 'line' } ]; function SyncedChartGroup() { // 同组图表共享的选中图例状态 const [currentActiveLegend, setCurrentActiveLegend] = useState(null); // 所有图表共用的图例双击处理回调 const handleLegendDoubleClick = useCallback((event) => { const clickedTraceName = event?.curve?.data?.name; // 重复双击同个图例时清空选中,恢复全量数据展示 setCurrentActiveLegend(prevState => prevState === clickedTraceName ? null : clickedTraceName ); }, []); // 根据当前选中状态,为单张图的所有轨迹配置可见性 const getConfiguredDataWithVisibility = (baseTraces) => { return baseTraces.map(traceItem => ({ ...traceItem, visible: currentActiveLegend ? (traceItem.name === currentActiveLegend ? true : 'legendonly') : true })); }; return ( <div style={{ display: 'flex', gap: '20px' }}> <Plot data={getConfiguredDataWithVisibility(baseChart1Data)} layout={{ width: 550, height: 400, title: '2023年经营数据' }} onLegendDoubleClick={handleLegendDoubleClick} /> <Plot data={getConfiguredDataWithVisibility(baseChart2Data)} layout={{ width: 550, height: 400, title: '2024年经营数据' }} onLegendDoubleClick={handleLegendDoubleClick} /> </div> ); }
落地注意事项
- 手动通过data控制轨迹可见性后,plotly原生的图例双击默认行为会自动被自定义逻辑覆盖,不需要额外配置参数关闭原生交互
- 如果需要扩展为更多图表的联动,只需要把共享的选中图例状态抽到所有同组图表的公共父组件作用域下即可,所有图表复用同一套回调和可见性处理逻辑,扩展成本极低
- 如果需要区分单击、双击图例的不同交互逻辑,可以直接从
onLegendDoubleClick的回调返回值里读取原生事件的标识字段做判断,不需要对接底层API做额外封装
内容的提问来源于stack exchange,提问作者Niuya
相关产品推荐
相关产品推荐

