【山竹记账前端-react】24.数据可视化
大纲链接 §
[toc]
1. 统计页面 ⇧
@/route/routes.tsx
|
|
@/pages/StatisticsPage.tsx
|
|
@/modules/statistics/ChartsSummary.tsx
|
|
安装
echarts
|
|
2. 封装折线图 ⇧
基本完成折线图结构样式 ⇧
添加简单的数据
@/modules/statistics/ChartsSummary.tsx
|
|
@/modules/statistics/DateAmountChart.tsx
|
|
- 外部数据参数
chartData?: { x: number | string; y: number }[]- x 轴数据
const xItems = chartData?.map((item) => item.x) - y 轴数据
const yItems = chartData?.map((item) => item.y)
- x 轴数据
- 声明图表节点
const chartDomRef = useRef<HTMLDivElement>(null) - 检查该 DOM 是否已经初始化过 ECharts 实例
echarts.getInstanceByDom(chartDomRef.current) - 初始化
chartInstance = echarts.init(chartDomRef.current) - 渲染
chartInstance.setOption(option) - 组件卸载或重新执行
effect前销毁实例return chartInstance?.dispose
自定义 tooltip ⇧
@/modules/statistics/DateAmountChart.tsx
|
|
- TODO: 使用
React.JSX实现安全的自定义tooltip - 区别于整体
option中的tooltip和series项目中的tooltip解构的数据名称也不同- 整体
option中的tooltip解构const { seriesName, marker, axisValue, data, } = params?.[0] ?? {}
- 整体
默认显示第一项数据的 tooltip ⇧
@/modules/statistics/DateAmountChart.tsx
配置
series项目中的tooltip1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98// import... import type { EChartsOption, TooltipComponentFormatterCallbackParams } from 'echarts' interface Props {/* ... */} export const DateAmountChart: React.FC<Props> = ({ className, chartData }) => { const chartId = useId() const chartDomRef = useRef<HTMLDivElement>(null) const xItems = chartData?.map((item) => item.x) const yItems = chartData?.map((item) => item.y) useEffect(() => { if (!chartDomRef.current) { return } // 1. 检查该 DOM 是否已经初始化过 ECharts 实例 let chartInstance = echarts.getInstanceByDom(chartDomRef.current) // 2. 如果没有,则进行初始化 if (!chartInstance) { chartInstance = echarts.init(chartDomRef.current) } const option: EChartsOption = { /* ... */ tooltip: { show: true, // 如果针对 series 单独设置,通常用 'item' trigger: 'item', confine: true, }, series: [ { name: '销量', type: 'line', data: yItems, emphasis: { focus: 'series', scale: 2, blurScope: 'series', itemStyle: { borderWidth: 3, }, }, tooltip: { show: true, confine: true, trigger: 'item', formatter: (params: TooltipComponentFormatterCallbackParams) => { const { seriesName, marker, name, data} = params const partsDate = name.split('-') const label = `${partsDate[0]}年${partsDate[1]}月${partsDate[2]}日` const dataValue = data === null ? '无数据' : `¥ ${data}元` return ` <div> <div> ${marker} ${seriesName} </div> <div> <span>${label}</span> <span>${dataValue}</span> </div> </div> ` }, }, }, ], } // 如果组件已经卸载,则不执行下一步渲染,防止严格模式(Strict Mode) 触发组件双重渲染 if (!chartInstance || chartInstance.isDisposed()) { return } // 3. 渲染你的图表数据 chartInstance.setOption(option) // 记录定时器 ID,并在回调中再次检查实例状态 const timer = setTimeout(() => { if (chartInstance.isDisposed() || xItems?.length === 0) { return } chartInstance?.dispatchAction({ type: 'showTip', // 轴触发类型(trigger: 'axis')时使用: seriesIndex: 0, // 第几个 series(通常为 0) dataIndex: 0, // 显示第一项(索引从 0 开始) }) }, 300) // 4. 组件卸载或重新执行 effect 前销毁实例 return () => { clearTimeout(timer) chartInstance?.dispose() } }, []) return <div ref={chartDomRef} id={chartId} className={cn(className)} /> }series项目中的tooltip解构const { seriesName, marker, name, data} = params在全局
tooltip中添加confine: true,强制将tooltip框限制在图表容器(chartDom)的内部,防止溢出边界默认
tooltip显示第一项(索引从 0 开始)- 使用
dispatchAction({type: 'showTip', ...})触发 - TODO: 优化
dispatchAction触发时机与位置
- 使用
TODO: 使用
React.JSX实现安全的自定义tooltipTODO: 将 初始化/销毁 与 数据更新 拆分为两个独立的
useEffecthttps://share.google/aimode/JMk45ObDFdiHgImAOTODO: 循环显示每一项
tooltip,类似轮播效果 https://share.google/aimode/HLsTcUdIskpYI1oXH
参考
- 使用 react 在 echarts 的 tooltip 中自定义组件
- 如何循环显示每一项 tooltip,类似轮播效果
- echarts 配置 series 中的 tooltip 无效
- 如何消除 echarts 警告 DateAmountChart.tsx:29 [ECharts] Instance ec_1794839466036 has been disposed
3. 封装折线图2:优化 ⇧
将 初始化/销毁 与 数据更新 拆分为两个独立的 useEffect ⇧
@/modules/statistics/DateAmountChart.tsx
|
|
- 第一个
useEffect负责在挂载时初始化,卸载时销毁- 避免重复初始化
- 1. 检查该 DOM 是否已经初始化过 ECharts 实例
- 2. 如果没有,则进行初始化
- 组件卸载或重新执行 effect 前销毁实例
- 第二个
useEffect负责监听chartData变化重新渲染图表- 如果组件已经卸载,则不执行下一步渲染,防止严格模式(Strict Mode) 触发组件双重渲染
- 构造
option - 注意
tooltip选项,顶层的option.tooltip才支持trigger: 'axis'和对应的formatter - 当顶层设置为
axis时,ECharts会完全忽略series内部的tooltip配置 - 渲染图表数据
添加 resize 监听窗口尺寸变化,重新渲染图表 ⇧
@/modules/statistics/DateAmountChart.tsx
|
|
轮播显示每一项 tooltip ⇧
封装
@/hooks/useChartCarousel.ts轮播图表数据
|
|
使用
@/modules/statistics/DateAmountChart.tsx
|
|
参考
4. 封装饼图 ⇧
封装 useChartLifeCycle ⇧
- 图表生命周期逻辑服用可封装为钩子函数
@/hooks/useChartLifeCycle.ts
|
|
快速实现饼图 ⇧
提供模拟外部传参数据
|
|
@/modules/statistics/AmountProportionChart.tsx
|
|
5. 封装排名组件 ⇧
提供模拟外部传参数据
|
|
@/modules/statistics/TagAmountRank.tsx
|
|
6. 添加下拉选项 ⇧
扩展 FormItemTypeProps 类型,添加 FormItem 的类型 optionSelector ⇧
@/components/form/item/FormItemType.ts
|
|
- 引入第二个泛型参数
export type FormItemTypeProps<T extends FormItemType, U = string> = T extends 'input'- 并且给默认类型
... = T extends 'input'
- 并且给默认类型
@/components/form/item/FormItem.tsx
|
|
- 泛型可选参数需要给默认类型
interface Props<T extends FormItemType, U extends string | number = string> - 类型传参
formItemTypeProps: FormItemTypeProps<T, U> case 'optionSelector':收窄类型<OptionSelector<U> type={formItemType} {...(formItemTypeProps as FormItemTypeProps<'optionSelector', U>)} .../>
实现 OptionSelector ⇧
@/components/form/item/OptionSelector.tsx
|
|
@/modules/statistics/ChartsSummary.tsx
|
|
后续单独优化二次封装 echarts 准备实现 ⇧
- 按需依赖引入
echarts组件- 类型约束,在 TypeScript 中按需引入
- 组件化封装复用,零侵入业务,业务图表(折线图、柱状图、饼图)全部基于基础图表组件
- 统一支持自定义 loading 加载状态、空数据兜底样式
- 挂载与销毁图表实例,防止内存泄漏
- 使用ref代替id的dom(防止id重复性)挂载
- 对比使用 监听
window的resize事件 和ResizeObserver监听- 使用
reactuse的useElementSize - 使用
reactuse的useResizeObserver - 自动监听窗口变化、自适应重绘,自动调整图表大小
- 重绘防抖;弹窗/隐藏容器展示图表延迟重绘
- 使用
- 对外抛出实例、配置,以供二次配置
- 交互事件
- 使用组件或钩子函数代替
tooltip中formatter的html与富文本(此项目弃用)- 并使用安全的转义
DOMPurify来处理html
- 并使用安全的转义
- 皮肤主题动态切换
- ECharts 图表导出 使用
toolbox.feature.saveAsImage或通过chart.getDataURL()获取图表数据并导出
参考文章
- 初始代码:https://github.com/FrankFang/XJJO9L
- 提交历史(新增8个提交):https://github.com/FrankFang/XLn4Pf/commits/master
- 最终代码:https://github.com/FrankFang/XLn4Pf/
相关文章
- 无
- 作者: Joel
- 文章链接:
- 版权声明
- 非自由转载-非商用-非衍生-保持署名