0.4.0 • Published 2 years ago

@clunch/bar v0.4.0

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

bar

📊 柱状图组件,包括直方柱状图和极坐标柱状图等常见的柱状图。

如何使用?

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

npm install --save clunch @clunch/bar

然后注册组件:

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

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

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

<ui-bar data='Array' ruler='Array<String>'/>
  • data:数据,应该是一个数组(比如:[[19,22,32],[1,22,3],[1,2,63],...][51,23,3,...]
  • ruler:刻度尺显示的内容(比如:["一月","二月","三月",...]

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

属性类型描述默认值可选值
xnumber图形左上角位置横坐标0
ynumber图形左上角位置纵坐标0
widthnumber图形宽画布的宽
heightnumber图形高画布的高
typestring图形的类型normalnormal、circle
colorsArray\<string>柱状条颜色内置循环色
max-valuenumber最大值动态计算得出
min-valuenumber最小值动态计算得出
ruler-colorstring刻度尺颜色black
item-rationumber条目占比0.90-1
bar-rationumber最小条目占比10-1

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

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

交互事件

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

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

<ui-bar data='Array' ruler='Array<String>' c-on:click='doit' />

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

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

打印的结果如下:

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

其中,target.subRegion的格式举例子:'1-3',表示你点击的是第二组的第四个条目。

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

开源协议


MIT

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

0.4.0

2 years ago

0.3.0

2 years ago

0.2.1

3 years ago

0.1.0

3 years ago

0.2.0

3 years ago

0.1.0-alpha

3 years ago

0.0.0-alpha

3 years ago