Skip to content

oi-contrib/VISLite

Repository files navigation

downloads npm cdn issue GitHub repo stars forks Gitee repo stars forks

NPM

VISLite

VISLite是一个使用TypeScript开发的可视化库。官网地址:https://oi-contrib.github.io/VISLite

主要提供了跨端的画布和计算,开发人员只需要按照文档的描述就可以非常简单的完成包括Web、uni-app、微信小程序、支付宝小程序等平台的可视化开发,除了初始化时可能存在一些差异外,主要的业务代码部分在不同端完全一致。

简介

这是一个轻量级的数据可视化资源库,目标是:帮助你更快速、简单、高效的开发出任意的可视化业务产品。

本项目已在开源中国中开源,欢迎关注和留言。

如何使用?

首先,需要进行安装:

npm install --save vislite

然后,准备好画布:

<div id="root" style="width:500px;height:300px;"></div>

现在,就可以获取画笔绘制自己需要的内容了。比如获取canvas画笔,绘制一个红色的圆:

import { Canvas } from 'vislite';

var painter = new Canvas(document.getElementById('root'));

painter.config({
    fillStyle: "red"
}).fillCircle(200, 150, 100);

更复杂的图表,我们也提供了丰富的辅助API。比如使用树布局,可以非常快速的绘制一个树图:

具体代码如下:

import { Canvas, TreeLayout } from 'vislite';

var painter = new Canvas(document.getElementById('root'));
var treeLayout = new TreeLayout();

treeLayout.setOption({
    type: "rect",
    direction: "TB",
    x: 250,
    y: 20,
    width: 500,
    height: 260
});

var data = {
    "name": "前端",
    "children": [{
        "name": "基础",
        "children": [{
            "name": "HTML"
        }, {
            "name": "CSS"
        }, {
            "name": "JavaScript"
        }, {
            "name": "DOM"
        }]
    }, {
        "name": "框架"
    }, {
        "name": "小技术"
    }]
};

var tree = treeLayout.use(data);

// 绘制连线
painter.config({
    strokeStyle: 'red'
});
for (var key in tree.node) {
    var pid = tree.node[key].pid;

    // 如果父结点存在,和父结点连起来
    if (pid) {
        var dist = (tree.node[key].top - tree.node[pid].top) * 0.5;

        painter
            .beginPath()
            .moveTo(tree.node[key].left, tree.node[key].top)
            .bezierCurveTo(
                tree.node[key].left, tree.node[key].top - dist,
                tree.node[pid].left, tree.node[pid].top + dist,
                tree.node[pid].left, tree.node[pid].top
            ).stroke();
    }
}

// 绘制节点和文字
painter.config({
    strokeStyle: 'red',
    fontSize: 12
});
for (var key in tree.node) {
    painter.config({
        fillStyle: "white"
    }).fullCircle(tree.node[key].left, tree.node[key].top, 10);

    painter.config({
        fillStyle: "black"
    }).fillText(key, tree.node[key].left + 15, tree.node[key].top);
}

关于树布局更具体的使用细节,你可以访问: 《教程 / 树布局》 一节。

部分功能

常用的算法

我们通过提供可视化常用的算法来帮助你绘制复杂图表。比如下面的树图,通过简单的配置就可以把任意格式的数据变成任意绘制的带坐标的数据:

上述例子的运行地址:从左到右树状图

除了树布局外,我们还提供了:刻度尺算法来帮助你计算刻度应该如何确定、等角斜方位投影墨卡托投影来绘制地图、插值函数来完成折线变光滑的曲线、变换矩阵提供各种坐标变换等。

画笔加强

我们对画笔进行了加强,使得其更简单好用。比如canvas,抽象出区域的概念,使得无论你绘制的图形多么的不规则,都可以很轻松的实现交互功能:

上述例子的运行地址:中国地图

画笔除了像上面那样为了方便交互而补充区域的设计外,还对原来的API进行了一次抽象,使得API更友好简单(比如WebGL,即使不会3D的人也可以轻松使用,而SVG的使用,你无需去记忆那些晦涩难懂的属性),同时,我们还抹平了不同版本浏览器等之间的差异。

支持跨端开发

除了Web端外,我们还针对uni-app、微信小程序、支付宝小程序等端进行了支持,并且不同端API保持一致,大大提高了代码的复用性:

上述例子的运行地址:金额波浪球

基于实际需要,我们目前对 Canvas 提供了跨端支持,除 Web端 外,还支持 原生微信小程序原生支付宝小程序uni-app端 (编译成H5、微信小程序、支付宝小程序等) ,如果后续有必要,我们会对Canvas支持的端或SVG、WebGL等画笔进行更多端扩展。

特点

  • 灵活的引入方式:包括npm安装后按照ES ModuleCommonJS规范引入或直接使用script标签的CDN方式。
  • 按需引入或全局引入:支持源码TS引入、按需JS引入或者全量引入等多种方式。
  • 简单与复杂共存:一方面我们提供了可视化需要的基础功能,你可以按照自己的需要组合使用;另一方面,为了加速开发,我们针对常见的可视化业务场景进行了封装,可以帮助你快速完成,你可以根据实际情况进行选择。
  • 向下兼容:我们向你保证,同一个大版本下始终向下兼容(alpha和beta版本为测试版本,不包括),因此,无论何时,在同一个大版本号下,最新版本总是最好的选择。

版本说明:alpha为开发阶段、beta为发布前测试、rc为候选版本、next为未来版本、无后缀的为正式版本。

需求墙

我们的目标是不断完善丰富可视化功能,非常希望获得你宝贵的建议和批评,无论任何想法,都可以给我们留言告诉我们。

你所提的任何建议我们都会在最长一周内进行反馈说明。

更新日志

详见正式版更新日志,我们会在每次发布完正式版本后更新其内容。

下一步

我们会在这里列出接下来的工作重心:

  • 为加速开发,提供常用坐标系和布局
  • 文档优化(提高可读性、丰富用例、补充教程)

给我们留言告诉我们你希望快速扩展的功能,我们会优先你的建议考虑哦~

参与贡献

你可以选择下列一项或多项进行参与:

  • 代码维护:由于新功能或一些BUG的出现,对代码进行维护和升级。
  • 文档编辑:主要是接口文档和教程需要编辑,这很重要。
  • 用例开发和测试:在项目的test文件夹下有一些测试,而在docs文档中存在一些例子需要补充。
  • 参与讨论:主要是讨论未来如何发展,改造的方向等。

如果有意向加入我们,你可以通过提 issue 和我们取到联系,请简单说明一下情况,我们会尽快回复。

你可以查看VISLite 贡献指南文件了解更多细节,查看AUTHORS.txt了解所有的贡献者。

例子项目

水分子式 H2O

手式解锁

3D环图

径向树状图

桑基图

可缩放折线图

从上到下树状图

可视化大屏

更多内容,你可以直接访问: https://oi-contrib.github.io/h5box/dataGUI/index.html

版权

MIT License

Copyright (c) zxl20070701 走一步,再走一步