忘了从哪里看到的了,有人问如何做一个 3D 饼图?当时翻了半天 ECharts-GL 配置项,但始终没有找到思路。
后来,在观摩学习曲面图(ECharts-GL 的 series-surface)的官方示例时,偶然得到了这个:
偶然把一个球拍扁了
当时特别激动,感觉 pie3D 大有希望了~
但是由于自己是第一次见到参数方程,当时完全没有理解,虽然一通瞎改弄出来了半圆和 1/4 圆,但任意角度的扇形半天也弄不出来……于是又搁置了
直到最近,忽然发现 Gallery 里的「3D 饼图尝试中」,居然有几个收藏(我当时设置的不是仅自己可见么)……
估计收藏的人是想看我最后能试出什么成果吧。想到这,心里顿时升起一种负罪感:让人家白白等了好几个月,我这却一点动静也没有
被这种负罪感驱使着,最近几天一有空就去想想、去试试,最后终于把想要的扇形做出来了。
3D 扇形
后面就相对容易了,花了些时间把 3D 饼图的提示框格式定制一下,再把选中效果、高亮(放大)效果尝试了下,最后写个自动生成 3D 饼图配置项的函数……最终得到了这样的效果:
最终效果
整体思路
首先要介绍一下 ECharts-GL 的曲面图 series-surface,这是一个基于三维直角坐标系(grid3D)的 3D 曲面,可以通过函数或者参数方程来描绘曲面,比如这些(官方示例):
3D surface 官方示例
然后得到 3D 扇形的思路就是
以球体的参数方程为基础,把 z 轴坐标压平,先得到一个圆柱;
newZ = oldZ > 0 ? 1 : -1;
先得到一个圆柱
然后再将圆柱不需要的部分,映射到截面上(分段函数),如下图,绿色映射到左侧截面,黄色映射到右侧截面,得到一个扇形;
再得到一个扇形
最后再将多个这类的扇形拼合,就组成了一个 3D 饼图。
最后得到一个 3D 饼图
具体实现
【一】定义一个函数,用于获得特定比例扇形的参数方程,其输入参数包括:
startRatio(浮点数): 当前扇形起始比例,取值区间 [0, endRatio)
endRatio(浮点数): 当前扇形结束比例,取值区间 (startRatio, 1]
isSelected(布尔值):是否选中,效果参照二维饼图选中效果(单选)
isHovered(布尔值): 是否放大,效果接近二维饼图高亮(放大)效果(未能实现阴影)
startRatio 和 endRatio
函数定义如下:
// 生成扇形的曲面参数方程,用于 series-surface.parametricEquation
【二】再定义一个:传入数据,生成 3D 饼图的配置项的函数。
其中传入数据的格式示意如下:
[{
函数定义如下:
// 生成模拟 3D 饼图的配置项
函数的流程大致是:
首次遍历传入的数据,为每一个数据项。准备对应的系列(series-surface)基础配置,存入列表「series」中,并计算数据值的总和 sumValue;
遍历列表「series」,为每一个系列补充对应的参数方程「series-surface.parametricEquation」,并在系列配置中记录生成参数方程所用的原始参数,startRatio、endRatio 等(isSelected、isHovered 在首次遍历时,已记录在 series-surface.pieStatus 中,均为默认值 false)
在列表「series」末尾追加一个透明的辅助系列,包在 3D 饼图周围,相当于一个「围栏」,用于判断鼠标是否移出饼图范围。
使用准备好的 series,组成完整的配置项 option,作为函数返回值。
【三】监听鼠标点击事件,实现饼图选中效果(单选)
// 用于记录上次选中的扇形对应的系列号 seriesIndex
- 主要就是先读取被点击扇形当前的状态,再调用函数「getParametricEquation」更新其参数方程,最后更新图表。
【四】结合辅助『围栏』,监听 mouseover 和 globalout 事件,近似实现高亮(放大)效果。
// 记录上次高亮的扇形对应的系列号 seriesIndex
大致思路是,在饼图外部套一层透明的圆环,然后监听 mouseover 事件,获取到对应数据的系列序号 params.seriesIndex 或系列名称 params.seriesName,如果鼠标移到了扇形上,则先取消高亮之前的扇形(如果有),再高亮当前扇形;如果鼠标移到了透明圆环上,则只取消高亮之前的扇形(如果有),不做任何高亮。
当鼠标移动过快,直接划出图表区域时,有可能监听不到透明圆环的 mouseover,导致此前高亮没能取消,所以补充了对 globalout 的监听。
👇阅读原文查看 ECharts Gallery 例子
本文分享自微信公众号 - ZXand618的ECharts之旅(ZXand618)。
如有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。