kLineChart

createView loadComplete

概述

kLineChart简介

金融行业中，有非常复杂的数据及专业知识。展示复杂数据最直观的方式就是各种类型的图表。K线图形态可分为反转形态、整理形态及缺口和趋向线等。后K线图因其细腻独到的标画方式而被引入到股市及期货市场。股市及期货市场中的K线图的画法包含四个数据，即开盘价、最高价、最低价、收盘价，所有的k线都是围绕这四个数据展开，反映大势的状况和价格信息。如果把每日的K线图放在一张纸上，就能得到日K线图，同样也可画出周K线图、月K线图

模块涉及到金融行业专业知识，有非常多的专有名词，使用者应当会了解其中涉及的大量专业名词，因此文档不会过多解释。模块基本属性较多，因此文档如有疏忽，请及时联系作者。

模块功能

  • 绘制K线联动图
  • 定制图表的所有可控样式
  • 动态分页载入数据
  • K线选中滑动回调
  • 自动计算常用基本指标
  • 图表缩放
  • 全屏显示

kLineChart 模块概述

本模块封装了Android原生端的高精度K线图表级联动图功能，用户需要一组简单的数据传入即可绘制出金融行业专业的K线图效果。

不能同时使用的模块：暂无

Android 系统平台上需注意事项

模块接口

createView

在指定位置创建一个自定义的View，用于绘制K线图，默认打开loading状态

createView({params}, callback(ret, err))

params

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  2.     event: 'loadMore', // loadMore  当开启分页加载，滑动到最左边触发 
  3.                        // select  长按K线选中滑动触发 
  4.     data: Object  //JSONObject 类型，当事件为select时，回调选中的K线信息
  5. }

示例代码

Android系统

可提供的1.0.0及更高版本

addFooterData

添加数据

addFooterData({params})

params

  1. {
  2.         "open": 59.99,  //开盘价
  4.         "close": 58.9,      // 收盘价
  5.         "high": 60.39,      //最高价
  6.         "low": 57.03,       //最低价
  7.         "volume": 8208535   //成交量
  8.     },
  9.     {
  10.         "open": 60,
  12.         "close": 58.51,
  13.         "high": 60.88,
  14.         "low": 58.5,
  15.         "volume": 10398563
  16.     }...]
  17. }

示例代码

可用性

Android系统

可提供的1.0.0及更高版本

loadComplete

使用此方法结束一次数据加载，表示K线图可以分页加载，既向左滑动时，可以触发loadMore回调，配合addFooterData方法，可以继续绘制图，直到调用loadEnd方法为止。用户可以配置计数器来做无限动态加载K线功能，这样既可以保证性能，又能保证加载速度。

loadComplete()

示例代码

  1. kLineChart.loadComplete()

此方法必须在调用addFooterData加载数据之后调用。默认调用addFooterData后，图表就会绘制。但是loading状态不会取消。只有调用loadloadComplete或者loadEnd方法才会结束loading状态。

可用性

Android系统

可提供的1.0.0及更高版本

loadEnd

确认数据加载完成，取消loading状态。在addFooterData调用后调用此方法。

使用此方法结束数据加载，表示K线图已经完成所有数据加载，此后向左滑动时，不会触发loadMore回调。调用此方法，表示K线图已经完全加载完毕。

loadEnd()

示例代码

补充说明

loadEnd调用表示图表的绘制完成完全结束，在调用此方法后，不得再调用其他方法，以免造成数据紊乱。

可用性

可提供的1.0.0及更高版本