0.3.0 • Published 2 years ago

@clunch/pie v0.3.0

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

pie

饼图组件,包括选中效果、文字说明等常见的饼图。

如何使用?

首先,需要安装npm包(目前我们仅支持npm方式管理):

npm install --save clunch @clunch/pie

然后注册组件:

import Clunch from 'clunch';
import pie from '@clunch/pie';

Clunch.series('ui-pie',pie);

然后,你就可以使用这个组件了:

<ui-pie data='Array' />
  • data:数据,应该是一个数组(比如:[{value:120,name:"苹果"},...]

除了上面的必输项外,还有下列可选项:

属性类型描述默认值可选值
cxnumber图形中心位置横坐标画布中心横坐标
cynumber图形中心位置纵坐标画布中心纵坐标
radiusnumber图形半径画布最小边的30%
inner-radiusnumber图形内半径0
label-showboolean是否显示提示文字true
colorsArray\<string>饼的颜色内置循环色
border-showboolean是否显示边框轮廓true

由于此组件是基于Clunch开发的,我们默认你已经掌握了相关知识。

<< 你可以点击此处学习Clunch.js如何使用

交互事件

图形绘制完成以后,我们可能还需要图形是可交互的,比如鼠标点击某个条目,可以提示对应的信息。

那么,我们可以对.clunch改造一下:

<ui-pie data='Array' c-on:click='doit'/>

然后,在new Clunch的时候添加doit方法

new Clunch({
    ......
    methods:{
        doit(target){
            console.log(target);
        }
    }
});

打印的结果如下:

target = {
    attr:当前组件的属性值
    data:你点击区域的信息
    left:点击位置的横坐标
    top:点击位置的纵坐标
    region:点击区域名称
    subRegion:点击子区域名称
    ......
}

其中,target.subRegion的格式举例子:'0',表示你点击的是第一个饼块。

这样子,你就可以添加弹框或者悬浮提示来实现和绘制图形的交互了!

开源协议

MIT

Copyright (c) 2021-2022 hai2007 走一步,再走一步。