ByteVCharts bytev-charts

打包及发布说明见开发者阅读

一个基于echarts和JavaScript及ES6封装，可以直接调用的图表组件库，内置多套主题设计，支持一键换肤，简单快捷，且支持用户自定义配置；

本产品适用于 ES6 和 vue的npm

npm版本: bytev-charts npm地址: https://www.npmjs.com/package/bytev-charts

原生js(ES6)版本地址: http://bytevcharts.bwk.ddns.net:90/

原生 - 实时版本: beta
原生 - 历史版本: version

示例和基础使用文档参考：http://www.bytevcharts.cn

使用方式和常用方法:

npm 安装方式:

npm install bytev-charts

若启动提示还需install其余插件, 则运行npm install @babel/runtime-corejs2即可;

npm install @babel/runtime-corejs2 


调用方式和原生js一致，在main.js中注册引入 import ByteV from 'bytev-charts'
自定义设置为vue的属性 如:
Vue.prototype.$bytev = ByteV;

原生js ES6:

	<script src="js/index.js" type="module">
	
		import ByteV from './ByteV.js'
		
                //后续代码及调用
                ByteV.
    
	</script>

使用方法和常用方法

		
    /*
     * 初始化主题	(每个主题的ID 可参见example示例)
     * 执行后则后续所有init的图表都自动使用此套主题
     * 不调用此方法则使用默认主题-加勒比蓝
     */
    
     ByteV.initTheme('主题ID')
    
    
    
    /*
     * 切换主题
     * 	图表实例.setTheme('主题ID'),则只修改该图表的主题
     * 	ByteV.setTheme('主题ID'),则修改全部图表主题,并且后续图表也使用修改后的主题
     */
    
     //切换指定图表主题
     实例.setTheme('主题ID')
     
     //切换全部图表主题
     ByteV.setTheme('主题ID')
     
     
     
    /*
     * 创建图表
     * 	创建图表实例(每个图表ID 可参见example示例)
     *  参数:	  element - dom对象(应该是唯一且不重复的)
     *  		图表ID - 可不传,不传默认返回空echarts对象
     *  		data - 图表数据,可不传,传则自动渲染数据,
     * 				   不传可后续用返回的实例调用.setData(data)来更新数据
     *  
     * 	返回值: 返回该图表的实例对象, 
     *	       实例对象有通用属性option, 和通用方法 setData()、setOption()
     */
    
     ByteV.init( element, '图表ID', data)
    
    
     
    /*
     * 修改更新图表option设置项的方法
     * 用户可通过 实例.option 获取其设置项,并自定义修改其中的值,
     * 修改后调用 实例.setOption() 即可刷新页面图表,也可与不调用,而是等setData()时一并更新,
     * 调用 实例.setData() 也会自动刷更新option和刷新该图表
     */
     图表实例.setOption()
    
    

    /*
    * 动画效果
    * 使用'ByteV'调用则是操作全部图表的动画
    * 使用'图表实例'调用只操作对应该图表的动画
    */
    //播放：
    ByteV.playAnimation()
    实例.playAnimation()
    
    //停止：
    ByteV.stopAnimation()
    实例.stopAnimation()
    
    //关闭：
    ByteV.offAnimation()
    实例.offAnimation()
    
    
    
    /*
    * 自动轮播
    * 使用'ByteV'调用则是操作全部图表的自动轮播
    * 使用'图表实例'调用只操作对应该图表的自动轮播
    */
    //开启：
    ByteV.openLoopTooltip()
    实例.openLoopTooltip()
    
    //关闭：
    ByteV.offLoopTooltip()
    实例.offLoopTooltip()

各版本更新内容：

1.0.2版: 

    新增“横向圆角堆叠柱状图”，“横向菱形堆叠柱状图”

1.0.3版: 

        1. echarts的柱状图折线图-增加了 支持调用setData()方法时一起设置样式的功能, 
            每个对象里面可以写echarts的官方属性,则对应组件会以用户写的样式为准来覆盖组件默认内置样式;

        2. 新增组件-堆叠柱线图

1.0.4版：

        1. 柱状图 饼状图 的x y 轴调整为数组结构, 方便用户自己在setData时手动自定义使用哪个轴线;

        2. 细阴影环形图的数据data中,为每个对象增加了parent属性, parent属性为string类型, 
            有该属性则插件自动求和该parent的值并显示到环形中间;

1.0.5 - 1.0.6版：

        1. 拆分出横向柱状图和柱线图组件类，规范横向柱状图和柱线图命名，新增几种横向柱状图图表;\

        2. 结构代码优化整理:
            将所有的series抽成独立的js管理; 

        3. 基本饼状图/基本环形图优化调整:
            3.1 调整默认center位置
            3.2 基本环形图增加支持每个数据的parent属性, parent属性为string类型, 
                有该属性则插件自动求和该parent的值并显示到环形中间;
            3.3 option下新增自定义属性center和radius,如果用户定义了这两个属性,则拼接的series直接以这两个属性动态计算

        4. 环形图(环星阴影图和环形十字准星图及玉珏图)优化调整:
            4.1 抽成环形图左右结构分类统一管理,并抽出拼接换算图例、parent的功能到父类js统一管理
            4.2 新增根据容器宽高比自动设置环图center位置,和自动设置图例展现方式(普通图例or可滚动翻页的图例/)
            4.3 图例新增unitType属性,支持根据用户设置来动态切换图例的三种单位文字显示方式:
                option.legend.unitType: 默认'none';
                    '' 或 'none' 或 null - 只显示名称, 
                    'value' - 显示名称+数值, 
                    'per' 或 '%' - 显示名称+百分比)；
            4.4 图例的icon属性新增自定义属性: '竖线' - 'verticalBar'
                    - option.legend.icon: (默认rect)
                    支持属性: 除echarts的('circle', 'rect', 'roundRect', 'triangle', 'diamond', 'pin', 'arrow', 'none'),
                    还新增了自定义属性'竖线' - 'verticalBar'
            4.5 优化环形图parent有无时label的动态样式和优化选中效果;
            4.6 option下新增自定义属性center和radius,如果用户定义了这两个属性,则拼接的series直接以这两个属性动态计算

        5. 命名调整(之前版本不受影响):
            5.1 横向菱形堆叠柱状图(v1.0.05版前BarHorizontalStackDiamond)    变更为=> 'HorizontalBarStackDiamond'
            5.2 横向圆角堆叠柱状图(v1.0.05版前BarHorizontalStackFillet)     变更为=> 'HorizontalBarStackFillet' 
            5.3 柱装饰折线图(v1.0.5版前LineBar)                            变更为=> 'LineDecorateBar'

1.0.7-1.0.8版：
        1. 修复用户自定义图表.option.color时,部分图表(如阴影环形图)的阴影颜色没有跟随变化的问题
        2. initTheme()和setTheme() 支持用户传入自定义颜色值数组, 届时对应图表的配色和装饰配色全根据自定义传入的色值数组取值;
                自定义的图表.option.color 比 theme颜色优先级高,但option.color只生效于图表部分,装饰配饰的颜色还是取theme中的;
                图表.option.color 和 theme 同时都自定义的时候, 图表部分的颜色优先取option.color,配饰装饰仍然继续取theme的色值;
        3. 饼状图、环形图优化
            3.1 修复在设置数据时,数据第一个为0时产生的计算错误问题; 
            3.2 修复在设置数据有parent时,数据自动++求和时精度不够的问题; 
            3.2 细阴影环形图内层带透明度的环形,修改和外层支持同样的悬浮事件label等;
            3.3 修复基本饼状图、基本环形图动态修改option直接子级属性center和radius不同步生效到series中的bug;
            3.3 修复基本饼状图、基本环形图即有parent父级、又有radius时内外环动态布局;
        4. three组件功能:
            初始化: ByteV.init(elment, '3D');(npm项目支持, 原生min.js暂不支持)

1.0.8-1.0.9版：
        1. 翻牌器组件, 增加option设置项: valueSameUpdate - 数值相同时是更新翻牌效果(默认false,数值相同不触发翻牌动作)
        2. 优化示例页面: 3D示例中的江苏地图示例, 增加风机模型
        3. 优化initTheme和seTheme时传入自定义色值数组的方法,修复色值constructor的报错(ThemeFactory-getTheme-default)
        4. 修复饼状图和环形图在数据只有一个的时候占比计算初NaN的问题