当前文档:《 Sprite API手册 我要修改这篇文章

combinedchart 组件使用


combinedchart组件主要用于复合BI图展现,目前支持柱状图,折线图,蜡烛图:

combinedchart组件考虑支持以下功能:

1:combinedchart组件需要在edn打包时勾选BI图表后方可正常使用;

2:combinedchart支持竖向柱状图,折线图,蜡烛共同显示;

3:combinedchart组件包复合图显示及区域说明两部分;

4:支持交互设置,包括:是否启用触摸交互,是否支持平移拖动,是否支持X轴/Y轴/XY轴手势缩放,是否设置比例缩放等;

5:图表区域支持设置背景色,网格展示设置;

6:X轴支持设置,包括:是否展现,是否绘制网格线,网格线是否虚线,X轴绘制位置(顶部/底部),X轴描述文字色,X轴描述文字大小,X轴绘制坐标最大值,X轴绘制坐标最小值,柱体之间最小间隔,显示分割label区域个数,是否居中绘制label值

7:Y轴包括两部分,左侧Y轴,右侧Y轴,均支持设置包括:是否展现,是否绘制网格线,网格线是否虚线, Y轴是否支持翻转,Y轴描述文字色,Y轴描述文字大小,Y轴绘制坐标最大值,Y轴绘制坐标最小值,描述文字位置(柱内/外)

8:柱状图及线性图相关图表样式参见 barchartlinechartcandlechart相关说明;

9:区域说明支持设置,包括:是否显示,描述样式(none/empty/default/square/circle/line),样式尺寸,描述文字大小,描述文字尺寸

10:图表支持展现动画,包括:X轴,Y轴,XY轴;

11:考虑提供以下方法,包括:

setConfig(jsonData:object):void 设置复合图参数

setData(jsonData:object):void 设置复合数据

addXLimitLine (data:object):string 添加X轴限制线

removeXLimitLine (id:string):void 移除指定X轴限制线

addLeftYLimitLine (data:object):string 添加左侧Y轴限制线

removeLeftYLimitLine (id:string):void 移除指定左侧Y轴限制线

removeAllLeftYLimitLine ():void 移除所有左侧Y轴限制线

addRightYLimitLine (data:object):string 添加右侧Y轴限制线

removeRightYLimitLine (id:string):void 移除指定右侧Y轴限制线

removeAllRightYLimitLine ():void 移除所有右侧Y轴限制线

invalidate():void 刷新复合图

setDrawValueEnabled(show:boolean):void 设置节点描述是否显示

setDrawHighlightEnabled(show:boolean):void 设置点击节点是否显示高亮标识线

setPinchZoomEnabled(show:boolean):void 设置是否比例缩放,true:比例放大缩小;false:单轴放大缩小

注:该组件为外置组件

属性

公共属性

参见公共属性章节,包括:id、style、class;

样式

公共样式

参见公共样式章节,包括:

尺寸

定位

外边距

背景 flexbox布局:align-self,flex

事件

本节目录:

valueSelected 选中指定区域触发

nothingSelected 取消区域选中触发

valueSelected

指定蜡烛体区域选中触发

event事件对象包括:

type:事件类型,字符串类型,固定值:valueSelected

target:触发事件的目标组件,dom对象

timestamp:事件触发的时间戳,单位毫秒,数字类型

param对象为Json对象,定义如下:

index:节点索引,从0开始,数字类型

//柱状图/折线图

xValue:节点X轴值,数字类型

yValue:节点Y轴值,数字类型

//蜡烛图

xValue:节点X轴值,数字类型

yValue:节点Y轴值,数字类型,(shadowH + shadowL)/2

open:节点初始值,数字类型

close:节点结束值,数字类型

shadowHigh:节点顶上影值,数字类型

shadowLow:节点底下影值,数字类型

注: highlightEnabled设置为true时触发

nothingSelected

取消区域选中触发

event事件对象包括:

type:事件类型,字符串类型,固定值:nothingSelected

target:触发事件的目标组件,dom对象

timestamp:事件触发的时间戳,单位毫秒,数字类型

注: highlightEnabled设置为true时触发

js方法

本节目录:

公共方法

setConfig(jsonData:object):void 设置复合图参数

setData(combineInfo:object):void 设置复合图数据

invalidate():void 刷新复合图数据

addXLimitLine (data:object):string 添加X轴限制线

removeXLimitLine (id:string):void 移除指定X轴限制线

removeAllXLimitLine ():void 移除所有X轴限制线

addLeftYLimitLine (data:object):string 添加左侧Y轴限制线

removeLeftYLimitLine (id:string):void 移除指定左侧Y轴限制线

removeAllLeftYLimitLine ():void 移除所有左侧Y轴限制线

addRightYLimitLine (data:object):string 添加右侧Y轴限制线

removeRightYLimitLine (id:string):void 移除指定右侧Y轴限制线

removeAllRightYLimitLine ():void 移除所有右侧Y轴限制线

setDrawValueEnabled(show:boolean):void 设置节点描述是否显示

setDrawHighlightEnabled(show:boolean):void 设置点击节点是否显示高亮标识线

setPinchZoomEnabled(show:boolean):void 设置是否比例缩放,true:比例放大缩小;false:单轴放大缩小

animateX(jsonData:object):void 启动复合图X轴动画

animateY(jsonData:object):void 启动复合图Y轴动画

animateXY(jsonData:object):void 启动复合图XY轴动画

snapshot(jsonData:Object): boolean 图表截屏,图片格式png

公共方法

事件相关,包括:

on(messageName:string,callback:Function): void 组件注册事件的触发函数

fire(messageName:string,params:Array<any>): void 组件事件的触发函数

off(messageName:string,callback:Function): void 组件移除事件的触发函数

getOn(messageName:string): Array<Function> 获取已绑定的事件的触发函数

动画相关,包括:

startAnimation(jsonData:Object,callback:Function): void 启动UI组件动画

startAnimator(jsonData:Object,callback:Function): void 启动UI组件属性动画

startKeyFrameAnimator(jsonData:Object,callback:Function): void 启动UI组件关键帧动画

releaseAnimator(): void 结束控件动画

尺寸和位置,包括:

getFrame(): Object 获取组件在父容器中的位置

setFrame(frame:Object): void 设置组件在父容器中的位置

getCenter(): Object 获取组件中心点在父容器中的位置

getAbsoluteFrame(): Object 获取组件在绘制窗口中的位置

普通Dom节点操作,包括:

getParent(): IElement 获取父节点

getNext(): IElement 获取同级下一个节点

getPrevious(): IElement 获取同级前一个节点

remove(): void 从父容器中移除自身

clone(isDeep:boolean):IElement 对当前Dom节点进行克隆

setAttr(attrName:string,attrValue:string): void 设置节点属性

getAttr(attrName:string):string 获取节点属性值

getAttrs(): Object 获取节点所有属性

removeAttr(attrName:string): void 移除节点属性

hasAttr(attrName:string): boolean 节点是否具有该属性

setStyle(styleName:string,styleValue:string): void 设置节点样式值

getStyle(styleName:string):string 获取节点样式值

clearStyle(styleName:string): void 移除节点样式值

setClassStyle(className:string,domobj:IElement): void 设置节点对应Class样式

getClassStyle(): string 获取节点已设置Class样式

getTag(): string 获取UI组件类型

getId(): string 获取UI组件Id标识

setConfig(jsonData:object):void

设置复合图参数

参数:

jsonData:参数,Json格式,格式定义如下:

基础设置

extraOffsets:图表周边空白间距,上 右 下 左,字符类型,如 10 5 10 5 默认 0 0 0 0

拖动设置

touchEnabled:是否启用图表触摸交互,boolean型,默认true

dragEnabled:是否启用图表拖动平移,boolean型,默认true

scaleEnabled:是否启用图表X轴及Y轴手势缩放,boolean型,默认true

scaleXEnabled:是否启用图表X轴手势缩放,boolean型,默认true

scaleYEnabled:是否启用图表Y轴手势缩放,boolean型,默认true

pinchZoom:是否XY轴比例缩放,boolean型,默认true

X轴样式

xEnabled:X轴是否展现,boolean型,默认true

xDrawGridLines:X轴是否绘制网格线,boolean型,默认true

xGridLineWidth:X轴网格线size,数字类型,单位dp,默认1

xGridLineColor:X轴网格线颜色,字符串类型,支持RGB(rgb(255, 0, 0)),十六进制(#rrggbb),默认#808080

xDrawAxisLines:X轴是否绘制线,boolean型,默认true

xPosition:X轴位置,字符串枚举型,【top,bottom,both_sided,top_inside,bottom_inside】默认bottom

xTextSize:文字大小,数字,单位dp,默认10

xTextColor:文字颜色,字符串类型,支持RGB(rgb(255, 0, 0)),十六进制(#rrggbb),默认#000000

xTextCenter:文字是否绘制于坐标中心,boolean型,默认false

xCustomTexts: x 轴 label 值,字符串数组类型,可选项

xDrawLabels: 是否绘制 x 轴 label 值,默认值为 true,bool 类型,可选项

左侧Y轴样式

yLeftEnabled:左侧Y轴是否展现,boolean型,默认true

yLeftInverted:左侧Y轴是否翻转显示,boolean型,默认false

yLeftDrawGridLines:左侧Y轴是否绘制网格线,boolean型,默认true

yLeftGridLineWidth:左侧Y轴网格线size,数字类型,单位dp,默认1

yLeftGridLineColor:左侧Y轴网格线颜色,字符串类型,支持RGB(rgb(255, 0, 0)),十六进制(#rrggbb),默认#808080

yLeftGridLineMode:左侧Y轴网格线模式,字符串枚举型,【normal,dashed】,normal:实线,dashed:虚线,默认normal

yLeftDrawAxisLines:左侧Y轴是否绘制线,boolean型,默认true

yLeftPosition:左侧Y轴位置,字符串枚举型,【outside_chart,inside_chart】默认outside_chart

yLeftTextSize:描述区域文字大小,数字,单位dp,默认10

yLeftTextColor:描述区域文字颜色,字符串类型,支持RGB(rgb(255, 0, 0)),十六进制(#rrggbb),默认#000000

yLeftDrawZeroLine:左侧Y轴是否绘制零轴线,boolean型,默认false

yLeftZeroLineWidth:左侧Y轴零轴线size,数字类型,单位dp,默认1

yLeftZeroLineColor:左侧Y轴零轴线颜色,字符串类型,支持RGB(rgb(255, 0, 0)),十六进制(#rrggbb),默认#808080

yLeftCustomTexts: 左侧y 轴 label 值,字符串数组类型,可选项

yLeftDrawLabels: 是否绘制左侧 y 轴 label 值,默认值为 true,bool 类型,可选项

右侧Y轴样式

yRightEnabled:右侧Y轴是否展现,boolean型,默认false

yRightInverted:右侧Y轴是否翻转显示,boolean型,默认false

yRightDrawGridLines:右侧Y轴是否绘制网格线,boolean型,默认true

yRightGridLineWidth:右侧Y轴网格线size,数字类型,单位dp,默认1

yRightGridLineColor:右侧Y轴网格线颜色,字符串类型,支持RGB(rgb(255, 0, 0)),十六进制(#rrggbb),默认#808080

yRightGridLineMode:右侧Y轴网格线模式,字符串枚举型,【normal,dashed】,normal:实线,dashed:虚线,默认normal

yRightDrawAxisLines:右侧Y轴是否绘制线,boolean型,默认true

yRightPosition:右侧Y轴位置,字符串枚举型,【outside_chart,inside_chart】默认outside_chart

yRightTextSize:描述区域文字大小,数字,单位dp,默认10

yRightTextColor:描述区域文字颜色,字符串类型,支持RGB(rgb(255, 0, 0)),十六进制(#rrggbb),默认#000000
yRightDrawZeroLine:右侧Y轴是否绘制零轴线,boolean型,默认false

yRightDrawZeroLine:右侧Y轴是否绘制零轴线,boolean型,默认false;

yRightZeroLineWidth:右侧Y轴零轴线size,数字类型,单位dp,默认1

yRightZeroLineColor:右侧Y轴零轴线颜色,字符串类型,支持RGB(rgb(255, 0, 0)),十六进制(#rrggbb),默认#808080

yRightCustomTexts: 右侧 y 轴 label 值, 字符串数组类型,可选项

yRightDrawLabels: 是否绘制右侧 y 轴 label 值,默认值为 true,bool 类型,可选项

描述区域设置

legendDrawInside:是否显示在图表区域内部,boolean型,默认false

legendVerticalAlignment:Y轴位置,字符串枚举型,【top, center, bottom】,默认bottom

legendHorizontalAlignment:X轴位置,字符串枚举型,【left, center, right】,默认left

legendOrientation:排序方向,字符串枚举型,【horizontal, vertical】,默认horizontal

legendXOffset:描述区域与图表X轴边缘间距,数字类型,默认5

legendYOffset:描述区域与图表Y轴边缘间距,数字类型,默认5

legendForm:描述区域形状,字符串枚举型,【none,empty,default,square,circle,line】,默认default

legendTextSize:描述区域文字大小,数字,单位dp,默认10

legendTextColor:描述区域文字颜色,字符串类型,支持RGB(rgb(255, 0, 0)),十六进制(#rrggbb),默认#000000

柱状图组模式设置

granularity:组模式下一个区域内包含组个数,数字,默认1

barSpace:柱之间间隔比例,数字

barWidth:柱库看度所占比例,数字

groupSpace:组之间间隔比例,数字

注:1 = (barSpace + barWidth) * barNumber + groupSpace

返回值:无

setData(combineInfo:object):void

设置复合图数据

参数:
combineInfo:复合图数据,json数据,定义如下:

//折线图数据
lineInfo:折线图数据,数组类型,数组成员为json格式,定义如下:

lineDatas:折线图数据,数组类型,数组成员为json格式,定义如下:

  • name:折线描述,字符串类型;
  • datas:折线数据集,数组类型,数据成员为json格式,定义如下:
    • xValue:X轴数值,数字类型;
    • yValue:Y轴数值,数字类型;
  • axis:折线基准Y轴,字符串枚举型,【left,right】,默认left即左侧Y轴
  • style:折线样式,json格式定义如下:

    //线

    • lineWidth:线size,数字类型,单位dp,默认1
    • lineColor:线颜色,字符串类型,支持RGB(rgb(255,0,0)),十六进制(#rrggbb),默认#000000;
    • lineMode:线模式,字符串枚举型,【normal,dashed】,normal:实线,dashed:虚线,默认normal;
    • lineDrawMode:线绘制连接模式,字符串枚举型,【linear,stepped,cubic_bezier,horizontal_bezier】,linear:线性模式,stepped:步进线模式,cubic_bezier:3D弧度线模式,horizontal_bezier:横向3D弧度线模式,默认linear

    //高亮线

    • highlightEnabled:点击节点是否显示高亮线,boolean型,true:显示高亮线,false:不显示高亮线,默认true
    • highlightLineWidth:高亮线size,数字类型,单位dp,默认1
    • highlightLineColor:高亮线颜色,字符串类型,支持RGB(rgb(255,0,0)),十六进制(#rrggbb),默认#ffbb73;
    • highlightLineMode:高亮线模式,字符串枚举型,【normal,dashed】,normal:实线,dashed:虚线,默认normal

    //节点文字

    • drawValues:是否绘制节点值,boolean型,true:绘制;false:不绘制(默认)
    • valueTextSize:节点文字大小,数字,单位dp,默认10;
    • valueTextColor:描述区域文字颜色,字符串类型,支持RGB(rgb(255,0,0)),十六进制(#rrggbb),默认#000000

    //节点圆

    • drawCircles:节点处是否绘制圆,boolean,true:绘制圆,false:不绘制圆,默认true
    • circleRadius:节点绘制圆半径,数字,单位dp,默认2
    • circleColor:节点绘制圆填充色,字符串类型,支持RGB(rgb(255,0,0)),十六进制(#rrggbb),默认#ff0000
    • drawCircleHole:节点处是否绘制中心圆孔,boolean,true:绘制圆孔,false:不绘制圆孔,默认true
    • circleHoleRadius:节点绘制圆孔半径,数字,单位dp,默认1
    • circleHoleColor:节点绘制圆孔填充色,字符串类型,支持RGB(rgb(255,0,0)),十六进制(#rrggbb),默认#ffffff

    //填充色

    • drawFilled:是否绘制折线与X坐标值之间填充色,bool型,true:绘制;false:不绘制,默认false;
    • filledColor:折线与X坐标值之间填充色色值,字符串类型,支持RGB(rgb(255,0,0)),十六进制(#rrggbb),默认#8ceaff
    • filledAlpha:折线与X坐标值之间填充色透明度,数字类型,取值范围【0-255】,0透明,255不透明,默认85

//柱状图数据
barInfo:柱状图数据,json格式,定义如下:

barDatas:柱状图数据,数组类型,数组成员为json格式,定义如下:

  • name:柱状描述,字符串类型
  • datas:柱状数据集,数组类型,数据成员为json格式,定义如下:
    • xValue:X轴数值,数字类型
    • yValue:Y轴数值,数字类型,用于普通柱状图
    • yValues:Y轴数值集,数组类型,数组成员为数字类型,用于复合栈柱状图
  • stackLabels:复合栈柱状图描述,数组类型,数组成员为字符串
  • axis:柱状基准Y轴,字符串枚举型,【left,right】,默认left即左侧Y轴
  • style:柱状样式,json格式定义如下:

    //填充色

    • colors:字符串数组,图表根据填充色数组依次填充柱体,数组元素为字符串类型,支持RGB(rgb(255,0,0)),十六进制(#rrggbb),默认#8ceaff

    //高亮色

    • highlightEnabled:点击是否显示高亮色,boolean型,true:点击高亮,false:点击不高亮,默认true
    • highlightColor:高亮填充颜色,字符串类型,支持RGB(rgb(255,0,0)),十六进制(#rrggbb),默认#ffbb73
    • highlightAlpha:高亮色遮罩透明度,数字类型,取值范围【0-255】,0透明,255不透明,默认120;

    //节点文字

    • drawValues:是否绘制节点值,boolean型,true:绘制(默认);false:不绘制
    • valueTextSize:节点文字大小,数字,单位dp,默认10;
    • valueTextColor:描述区域文字颜色,字符串类型,支持RGB(rgb(255,0,0)),十六进制(#rrggbb),默认#000000;

//蜡烛图数据
candleInfo:蜡烛图数据,json类型,定义如下:

candleDatas:蜡烛图数据,数组类型,数组成员为json格式,定义如下:

  • name:蜡烛图描述,字符串类型;
  • datas:蜡烛图数据集,数组类型,数据成员为json格式,定义如下:
    • xValue:X轴数值,数字类型;
    • open:节点初始值,数字类型;
    • close:节点结束值,数字类型;
    • shadowHigh:节点顶上影值,数字类型;
    • shadowLow:节点底下影值,数字类型;
  • axis:基准Y轴,字符串枚举型,【left,right】,默认left即左侧Y轴;
  • style:样式,json格式定义如下:

    //影线

    • shadowWidth:影线size,数字类型,单位dp,默认1;
    • shadowColor:影线颜色,字符串类型,支持RGB(rgb(255,0,0)),十六进制(#rrggbb),默认#000000;
    • showCandleBar:是否显示蜡烛柱体区域,bool型,true:显示柱体(默认);false:不显示柱体;
    • shadowColorSameAsCandle:影线颜色是否与柱体色相同,bool型,true:相同(默认),false:不同;

    //蜡烛柱体

    • decreasingColor:减柱(open>close)颜色,字符串类型,支持RGB(rgb(255,0,0)),十六进制(#rrggbb),默认#7af254;
    • decreasingPaintStyle:减柱(open>close)绘制模式,字符串枚举型,【fill,stroke】,默认stroke;
    • increasingColor:增柱(open<close)颜色,字符串类型,支持RGB(rgb(255,0,0)),十六进制(#rrggbb),默认#ff0000
    • increasingPaintStyle:增柱(open<close)绘制模式,字符串枚举型,【fill,stroke】,默认fill;
    • neutralColor:平柱(open == close)颜色,字符串类型,支持RGB(rgb(255,0,0)),十六进制(#rrggbb),默认#ff0000;
    • barsSpace:蜡烛柱体之间间隔比例,数字类型,0-0.45,默认0.1;

    //高亮线

    • highlightEnabled:点击节点是否显示高亮线,boolean型,true:显示高亮线,false:不显示高亮线,默认true;
    • highlightLineWidth:高亮线size,数字类型,单位dp,默认1;
    • highlightLineColor:高亮线颜色,字符串类型,支持RGB(rgb(255,0,0)),十六进制(#rrggbb),默认#ffbb73;
    • highlightLineMode: 高亮线模式,字符串枚举型,【normal,dashed】,normal:实线,dashed:虚线,默认normal;

    //节点值

    • drawValues:是否绘制文字,boolean型,true:绘制;false:不绘制(默认);
    • valueTextSize:文字大小,数字,单位dp,默认10;
    • valueTextColor:文字颜色,字符串类型,支持RGB(rgb(255,0,0)),十六进制(#rrggbb),默认#000000;

xAxisMinimum:设置图表显示x轴最小值,数字类型,默认无

xAxisMaximum:设置图表显示x轴最大值,数字类型,默认无

yLeftAxisMinimum:设置图表显示左侧Y轴最小值,数字类型,默认无

yLeftAxisMaximum:设置图表显示左侧Y轴最大值,数字类型,默认无

yRightAxisMinimum:设置图表显示右侧Y轴最小值,数字类型,默认无

yRightAxisMaximum:设置图表显示右侧Y轴最大值,数字类型,默认无

返回值:无

注: 建议先调用setConfig方法再调用setData

invalidate():void

刷新复合图数据

参数:无

返回值:无

注: 数据改变或配置改变后,需调用该方法刷新复合图展现

addXLimitLine (data:object):string

添加X轴限制线

参数:

data:添加X轴限制线,json格式定义如下:

name:限制线描述,字符串类型
value:限制线X轴值,数字类型
style:限制样式,json格式定义如下:

  • lineWidth:线size,数字类型,单位dp,默认1
  • lineColor:线颜色,字符串类型,支持RGB(rgb(255, 0, 0)),十六进制(#rrggbb),默认#ed5b5b
  • lineMode:线模式,字符串枚举型,【normal,dashed】,normal:实线,dashed:虚线,默认normal
  • labelPosition:描述文字绘制位置,字符串枚举型,【left_top,left_bottom,right_top,right_bottom】,默认right_top
  • labelSize:描述文字大小,数字,单位dp,默认10
  • labelColor:描述区域文字颜色,字符串类型,支持RGB(rgb(255, 0, 0)),十六进制(#rrggbb),默认#000000

返回值:添加限制线标识,字符串类型

注: 需调用invalidate刷新方可生效

removeXLimitLine (id:string):void

移除指定X轴限制线

参数:

id:需要移除X轴限制线标识,字符串类型,必选项

返回值:无

注: 需调用invalidate刷新方可生效

removeAllXLimitLine ():void

移除所有X轴限制线

参数:无

返回值:无

注: 需调用invalidate刷新方可生效

addLeftYLimitLine (data:object):string

添加左侧Y轴限制线

参数:

data:添加左侧Y轴限制线,json格式定义如下:

name:限制线描述,字符串类型
value:限制线Y轴值,数字类型
style:限制样式,json格式定义如下:

  • lineWidth:线size,数字类型,单位dp,默认1
  • lineColor:线颜色,字符串类型,支持RGB(rgb(255, 0, 0)),十六进制(#rrggbb),默认#ed5b5b
  • lineMode:线模式,字符串枚举型,【normal,dashed】,normal:实线,dashed:虚线,默认normal
  • labelPosition:描述文字绘制位置,字符串枚举型,【left_top,left_bottom,right_top,right_bottom】,默认right_top
  • labelSize:描述文字大小,数字,单位dp,默认10
  • labelColor:描述区域文字颜色,字符串类型,支持RGB(rgb(255, 0, 0)),十六进制(#rrggbb),默认#000000

返回值:添加限制线标识,字符串类型

注: 需调用invalidate刷新方可生效

removeLeftYLimitLine (id:string):void

移除指定左侧Y轴限制线

参数:

id:需要移除左侧Y轴限制线标识,字符串类型,必选项

返回值:无

注: 需调用invalidate刷新方可生效

removeAllLeftYLimitLine ():void

移除所有左侧Y轴限制线

参数:无

返回值:无

注: 需调用invalidate刷新方可生效

addRightYLimitLine (data:object):string

添加右侧Y轴限制线

参数:

data:添加右侧Y轴限制线,json格式定义如下:

name:限制线描述,字符串类型
value:限制线Y轴值,数字类型
style:限制样式,json格式定义如下:

  • lineWidth:线size,数字类型,单位dp,默认1
  • lineColor:线颜色,字符串类型,支持RGB(rgb(255, 0, 0)),十六进制(#rrggbb),默认#ed5b5b
  • lineMode:线模式,字符串枚举型,【normal,dashed】,normal:实线,dashed:虚线,默认normal
  • labelPosition:描述文字绘制位置,字符串枚举型,【left_top,left_bottom,right_top,right_bottom】,默认right_top
  • labelSize:描述文字大小,数字,单位dp,默认10
  • labelColor:描述区域文字颜色,字符串类型,支持RGB(rgb(255, 0, 0)),十六进制(#rrggbb),默认#000000

返回值:添加限制线标识,字符串类型

注: 需调用invalidate刷新方可生效

removeRightYLimitLine (id:string):void

移除指定右侧Y轴限制线

参数:

id:需要移除右侧Y轴限制线标识,字符串类型,必选项

返回值:无

注: 需调用invalidate刷新方可生效

removeAllRightYLimitLine ():void

移除所有右侧Y轴限制线

参数:无

返回值:无

注: 需调用invalidate刷新方可生效

setDrawValueEnabled (show:boolean):void

设置节点值是否显示

参数:

show:节点值是否显示,boolean型,true:显示;false:不显示,必选项

返回值:无

注: 需调用invalidate刷新方可生效

setDrawHighlightEnabled (show:boolean):void

设置点击节点是否显示高亮标识线

参数:

show:点击节点是否显示高亮标识线,boolean型,true:显示;false:不显示,必选项

返回值:无

注: 需调用invalidate刷新方可生效

setPinchZoomEnabled (show:boolean):void

设置是否XY轴比例缩放

参数:

show:是否XY轴比例缩放,boolean型,true:比例缩放;false:单轴缩放,必选项

返回值:无

注: 需调用invalidate刷新方可生效

animateX(jsonData:object):void

启动复合图X轴动画

参数:

jsonData:动画参数,json格式,定义如下:

durationMillis:动画执行时间,数字类型,必选项,单位毫秒
easingOption:动画执行速率配置,字符枚举型,【ease_in, ease_out, ease_in_out, linear】,可选项,ease_in:动画启动的时候慢;ease_out:动画结束的时候慢;ease_in_out:动画启动时候慢,中间快,结束的时候慢;linear动画速度不变(默认);

返回值:无

animateY(jsonData:object):void

启动复合图Y轴动画

参数:

jsonData:动画参数,json格式,定义如下:

durationMillis:动画执行时间,数字类型,必选项,单位毫秒
easingOption:动画执行速率配置,字符枚举型,【ease_in, ease_out, ease_in_out, linear】,可选项,ease_in:动画启动的时候慢;ease_out:动画结束的时候慢;ease_in_out:动画启动时候慢,中间快,结束的时候慢;linear动画速度不变(默认);

返回值:无

animateXY(jsonData:object):void

启动复合图XY轴动画

参数:

jsonData:动画参数,json格式,定义如下:

durationMillisX:x轴动画执行时间,数字类型,必选项,单位毫秒

easingOptionX:x轴动画执行速率配置,字符枚举型,【ease_in, ease_out, ease_in_out, linear】,可选项,ease_in:动画启动的时候慢;ease_out:动画结束的时候慢;ease_in_out:动画启动时候慢,中间快,结束的时候慢;linear动画速度不变(默认);

durationMillisY:y轴动画执行时间,数字类型,必选项,单位毫秒

easingOptionY:y轴动画执行速率配置,字符枚举型,【ease_in, ease_out, ease_in_out, linear】,可选项,ease_in:动画启动的时候慢;ease_out:动画结束的时候慢;ease_in_out:动画启动时候慢,中间快,结束的时候慢;linear动画速度不变(默认);

snapshot(jsonData:Object): boolean

图表截屏,图片格式png

参数:

jsonData:截屏参数,Json对象,定义如下:

path:截屏保存图片文件路径(包含文件名),支持res: file:,字符串类型,必选项;

返回值:截屏是否成功,成功返回true,失败返回false