@clunch/pie

0.3.0 • Public • Published

pie

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

downloads Version GitHub repo commit License GitHub repo stars

如何使用?

首先,需要安装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:"苹果"},...]

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

属性 类型 描述 默认值 可选值
cx number 图形中心位置横坐标 画布中心横坐标
cy number 图形中心位置纵坐标 画布中心纵坐标
radius number 图形半径 画布最小边的30%
inner-radius number 图形内半径 0
label-show boolean 是否显示提示文字 true
colors Array<string> 饼的颜色 内置循环色
border-show boolean 是否显示边框轮廓 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 走一步,再走一步。

Readme

Keywords

Package Sidebar

Install

npm i @clunch/pie

Weekly Downloads

11

Version

0.3.0

License

MIT

Unpacked Size

245 kB

Total Files

9

Last publish

Collaborators

  • hai2007