作者:心叶
时间:2019-01-23 17:55
温馨提示:clay.js已经停止维护,项目迁移到
https://github.com/yelloxing/…
准备环境
我们需要用到的库有三个:
- clay-core:提供核心的clay.js操作;
- clay-2d:提供Web端2d图形绘制接口;
- clay-chart:提供绘制常用表格的数据计算方法,这里是tree。
你可以去github上下载最新的发布版本并引入,或者通过npm install安装并通过require的方式使用(具体的你可以在github上看到详细的说明)。
这里,我们选择npm管理,然后引入node_modules中的文件:
npm install --save clay-core clay-2d clay-chart
这样,我们就准备好了npm包,接着在html中引入他们:
<script src="../node_modules/clay-core/build/clay-core.js"></script>
<script src="../node_modules/clay-2d/build/clay-2d.js"></script>
<script src="../node_modules/clay-chart/build/clay-chart.js"></script>
我们推荐你在实际开发中通过require方式使用,这里是为了演示方便。
需要说明
目前,开发环境已经准备好了,因为绘制树图,我们需要模拟数据,你可以在这里下载数据:
https://github.com/chen351012…
我们要绘制一棵圆形树,一点点显示,你可以clone最终代码,查看效果:
git clone https://github.com/chen351012/eChart.js
cd eChart.js
npm install
然后在浏览器中打开 ./src/svg.tree.rotate.html 即可查看效果。
计算结点位置
var tree=$chart.tree({
// 目标树
"type": "circle",
"radius": 300, "cx": 350, "cy": 350,
// 数据结构
"root": initTree => initTree,
"child": parentTree => parentTree.children,
"id": treedata => treedata.name
});
第一步,如上面所示,配置树图的计算对象,根据原始数据计算每个结点的位置(具体的配置参数,你可以在clay-chart项目的文档中查看)。
var result=tree(program.data);
第二步,使用刚刚获取的树图计算对象,传递原始数据,获取包含了结点位置等信息的结果result。
余下的就是绘制图形了。
SVG结点绑定
因为这里我们选择的是svg绘图,在绘制前,我们可以使用data方法,把数据和g标签关联起来,这样绘图更容易:
var gs=$$('svg').find('g').data(result.node).enter('g').appendTo('svg');
上面就把每个结点的信息挂载到g标签中,具体的api你可以查看clay-core的文档。
绘图
最后,我们来绘图吧!
gs.loop(function (data, index, target) {
window.setTimeout(function () {
// 在这里绘制结点和连线条
}, index * 50);
});
gs就是和结点挂载起来的g标签对象,上面的loop方法会在每一个g标签上启动传递的函数,函数有三个参数,在这里分别是:
- data:包含位置信息的结点数据
- index:数据序号,也就是是第几个结点
- target:当前操作的g标签对象(类似是clay对象)
我们发现,上面二个结点间绘制图形相差50ms,也就有了动画效果,下面在里面添加结点和连线条的绘制方法即可:
// 绘制连线
if (data.pid) {
var pnode = $$('[id=' + data.pid + ']');
$$('<path>')
.css({ "fill": "none", "stroke": "gray" })
.attr('d', bezier(+pnode.attr('left'), +pnode.attr('top'), data.left, data.top))
.appendTo(target)
}
根节点没有父亲,不需要绘制连线。这里绘制连线的方法由clay-2d提供。
// 绘制结点
$$('<circle stroke-width="1" fill="red" r="3">')
.attr('cx', data.left).attr('cy', data.top).css("fill", "#ea779e")
.appendTo(target);
至此,就结束了,你可以在这里查看完整代码:https://github.com/chen351012…
后记
你可以看出来,clay-core提供了绘图中最基本的操作,比如对结点的增删改查和基本的计算等;而如果我们需要绘制常见的图形,比如扇形或这里的曲线等,由clay-2d提供(后期绘制3d会由clay-3d提供);而在绘制复杂图形的时候,比如这里的tree,我们需要计算每个结点的位置,就由clay-chart提供。
这样的好处是灵活性高,比如这里,如果我们想使用canvas2D绘图,只需要修改绘图方法为clay-2d中提供的canvas2D方法即可!