Skip to content

An Easy-to-Use and Perfect K-Line Library,安卓易用完善K线,Kchart,CandleLine,Kline(比特币,虚拟币,股票,外汇),指标线(MACD,WR,KDJ,RSI),ChartView

Notifications You must be signed in to change notification settings

zhuoCreator/KlineChart-1

 
 

Repository files navigation

kline(尽量避免改动源码,方便修复bug重新依赖)


  • 有问题可以加群反馈,优化功能会同步到群
  • QQ群: 163565953 点击加群
  • 功能持续优化,好用容易接入的K线

效果图

使用步骤:

  1. 添加依赖

         项目的build.gradle中
    
                     buildscript {
    
                        repositories {
                           ...
                            jcenter()
    
                        }
                        ...
                     }
    
                     allprojects {
                        repositories {
                        ...
                            jcenter()
                        }
                     }
         
         
         工程的build.gradle中
    
                     implementation 'com.icechao.klinelib:klinelib:0.0.7'
    
  2. 继承KlineEntry实现Bean类,复写对应方法返回 高 开 低 收 量 时间

         public class KChartBean extends KLineEntity {
         //必须复写此方法返回毫秒值
         @Override
         public Long getDate() {
           try {
               return new SimpleDateFormat("yyy/MM/dd").parse(date).getTime();
           } catch (ParseException e) {
               e.printStackTrace();
               return 0L;
           }
         }
         //必须复写此方法返回开盘价
         @Override
         public float getOpenPrice() {
           return open;
         }
         //必须复写此方法返回最高价
         @Override
         public float getHighPrice() {
           return high;
         }
         //必须复写此方法返回最高价
         @Override
         public float getLowPrice() {
           return low;
         }
         //必须复写此方法返回收盘价
         @Override
         public float getClosePrice() {
           return close;
         }
         //必须复写此方法返回成交量
         @Override
         public float getVolume() {
           return volume;
         }
         //其他方法不做限制
         ......
         }
    
  3. 在布局中使用

         <com.icechao.klinelib.view.KLineChartView
          android:id="@+id/kLineChartView"
          android:layout_width="matchParent"
          android:layout_height="580dp"
          android:background="@color/color_081734"
          //可添加自定义属性设置,也可在代码中设置
          />
    

    支持自定义属性

    属性名称 属性值 属性含义 默认值
    fitXLabel boolean X轴的最两边坐标向内缩进 true,可能会引起X轴label重叠可设置为false
    maiLengendMarginTop dimension 主视图Lengend上边距 10
    paddingBottom dimension chart上部内容边距 15,底部显示X轴label空间
    paddingTop dimension 主视图Lengend上边距 30,第一个网格的位置
    childPaddingTop dimension 所有子视图上边距 15
    chartLogo resource 主视图logo
    candleRightPadding dimension 主视图与右侧内边距
    increaseColor color 涨颜色
    backgroundColor color 背景色
    decreaseColor color 跌颜色
    chartTextSize dimension 通用文字大小
    textColor color 文字颜色
    limitTextColor color 最大最小值文字颜色
    limitTextSize dimension 最大最小值文字大小
    lineWidth dimension 指标线线宽
    klineItemWidth dimension 蜡烛图加外围空隙宽
    candleWidth dimension 蜡烛图柱宽
    candleLineWidth dimension K线空心时宽度
    priceLineWidth dimension 价格线宽 1dp
    priceLineColor color 价格线颜色
    priceLineRightColor color 价格线右侧虚线时颜色
    priceLineRightTextColor color 价格线右侧虚线价格文字颜色
    priceLineBackgroundColor color 价格线横框背景色 #CFD3A9
    priceLineBoxMarginRight dimension 价格框右边距 120
    priceLineBoxShapeWidth dimension 价格线框内三角形占宽 10
    priceLineBoxShapeHeight dimension 价格线框内三角形占高 20
    priceLineBoxHeight dimension 价格线上的框高度 40
    priceLineBoxPadding dimension 价格线上的框的内边距 20
    priceLineBoxShapeTextMargin dimension 价格框文字与图形距离 10
    priceLineBoxBorderWidth dimension 价格线框边框宽度 1
    priceLineBoxBorderColor dimension 价格线框边框颜色
    backgroundFillTopColor color 背景渐变上部颜色
    backgroundFillBottomColor color 背景渐变下部颜色
    backgroundAlpha integer 背景色透明度
    backgroundFillAlpha integer 背景色填充透明度
    yLabelMarginRight dimension y轴上label与右侧边距 10
    timeLineColor color 分时线颜色
    timeLineFillTopColor color 分时线填充渐变上部颜色
    timeLineFillBottomColor color 背景色渐变下部颜色
    timeLine_endPointColor color 分时线尾颜色
    timeLine_endMultiply int 分时线尾圆变化最大倍数
    timeLine_endRadiu dimension 分时线尾圆半径
    candleSolid boolean K线是否空心 false
    gridLineWidth dimension 网格线宽
    gridLineColor color 网格颜色
    gridLineColumns integer 网格列数
    gridLineRows integer 网格行数
    selectXLineWidth dimension 选中十字线X轴线宽
    selectLabelBoderWidth dimension 选中十字线label边框线宽 2
    selectLabelBoderColor color 选中坐标边框颜色
    selectYLineWidth dimension 十字线Y轴线宽
    selectXLineColor color 选中十字线X线颜色
    selectYLineColor color 选中十字线Y线画笔颜色
    selectYColor color 选中十字线Y轴渐变色,-1时不绘制渐变
    selectCrossBigColor color 选中十字线相交点圆颜色
    selectCrossPointColor color 选中十字线相交点圆颜色
    selectShowCrossPoint color 是否显示选中十字线相交点圆
    selectCrossPointRadiu color 选中十字线相交点小圆半径
    selectPriceBoxBackgroundColor color 选中价格框背景色
    selectPriceBoxHorizentalPadding dimension 选中价格框的横向padding,三角形的高为横+纵padding 4dp
    selectPriceBox_verticalPadding dimension 选中价格框的纵向向padding,三角形的高为横+纵padding 2dp
    selectInfoBoxMargin dimension 选中行弹出框的margin
    selectInfoBoxPadding dimension 选中行弹出框行间距,上下为此值*2
    selectInfoBoxTextColor dimension 选中行弹出框文字颜色 Color.WHITE
    selectInfoBoxBorderColor dimension 选中行弹出框边框颜色 Color.WHITE
    selectInfoBoxBackgroundColor dimension 选中行弹出框背景颜色 Color.DKGRAY
    selectTextSize dimension 选择框文字大小
    macdIncreaseColor color macd标准线上柱颜色
    macdDecreaseColor color macd标准线下柱颜色
    macdWidth dimension macd柱状图宽度
    difColor color dif线颜色
    deaColor color dea线颜色
    macdColor color macd线颜色
    kColor color k线的颜色
    dColor color d线的颜色
    jColor color j线的颜色
    rsi1Color color 第1根rsi线的颜色
    rsi2Color color 第2根rsi线的颜色 暂无
    ris3Color color 第3根rsi线的颜色 暂无
    upColor color up线颜色
    mbColor color mb线颜色
    dnColor color dn线颜色
    wr1Color color 第1根wr线的颜色
    wr2Color color 第2根wr线的颜色 暂无
    wr3Color color 第3根wr线的颜色 暂无
    ma1Color color 第1根ma线的颜色
    ma2Color color 第2根ma线的颜色
    ma3Color color 第3根ma线的颜色
    volLengendColor color 成交量图例颜色
    volLineChartColor color 成交量显示线状图时的颜色 #4B85D6
    volLengendMarginTop dimension 成交量图例距离成交量顶部距离 10
  4. 初始化k线

         //设置数据适配器
         chartView.setAdapter(adapter)
                 //设置开场动画
                 .setAnimLoadData(false)
                 //添加日期格式化,可动态修改
                 .setDateTimeFormatter(new DateFormatter())
                 //网格列
                 .setGridColumns(5)
                 //网格行
                 .setGridRows(5)
                 //logo
                 .setLogoBigmap(bitmap)
                 //logo透明度
                 .setLogoAlpha(100)
                 //左滑超出宽度
                 .setOverScrollRange(getWindowManager().getDefaultDisplay().getWidth() / 5)
                 //滑动边界监听(可能重复调用)
                 .setSlidListener(new SlidListener() {
                     @Override
                     public void onSlidLeft() {
                         LogUtil.e("onSlidLeft");
                     }
    
                     @Override
                     public void onSlidRight() {
                         LogUtil.e("onSlidRight");
                     }
                 })
                 //Y值精度格式化(可重复设置)
                 .setValueFormatter(new ValueFormatter() {
                     @Override
                     public String format(float value) {
                         return String.format("%.03f", value);
                     }
                 })
                 //成交量格式化
                 .setVolFormatter(new ValueFormatter() {
                     @Override
                     public String format(float value) {
                         return String.format("%.03f", value);
                     }
                 })
                 //设置loadingView
                 .setLoadingView(textView)
                 //显示loading
                 .showLoading();
    
  5. 使用KLineChartAdapter设置数据

         如果没有将数据适配器保存可以通过ChartView的getAdapter方法获取
         chartView.getAdapter()
    
         填充或重新填充数据,bool表示是否重置展示位
         resetData(List<KlineEntry>,boolean);
    
         尾部追加数据 
         addLast(KlineEntry);
    
         修改某个数据 
         changeItem(KlineEntry);
    
         如果有需要在前面追加多个数据可以继承KLineChartAdapter自定义方法参考addLast方法
         
         添加完数据后需要手动隐藏loading
         chartView.hideLoading();
    
  6. (可选)解决滑动冲突

         滑动布局使用 com.icechao.klinelib.view.ScrollView
    

更多API查看KLineChartView或加QQ群咨询

部分API ________ kLineChartView为KLineChartView对象

Loadding展示

   kLineChartView.justShowLoading() ;
   
        只显示loading不会显示后面的K线,K线部队只显示背景
        
   kLineChartView.showLoading();
   
        显示loading的同时显示K线

主图MA/BOLL切换

    kLineChartView.changeMainDrawType(Status.MainStatus.MA);
        参数    
        Status.MainStatus.MA, : 显示ma  默认值
        Status.MainStatus.BOLL: 显示boll
        Status.MainStatus.NONE: 只显示CandleLine

子图指标图切换

    kLineChartView.setIndexdDraw(Status.ChildStatus.MACD);
        参数
        Status.ChildStatus.NONE : //不显示子图  默认值
        Status.ChildStatus.MACD : macd
        Status.ChildStatus. KDJ : kdj
        Status.ChildStatus.RSI  : rsi
        Status.ChildStatus.WR   : wr

设置是适应X左右边轴坐标的位置

    kLineChartView.setBetterX(boolean betterX);
        参数
        true : X轴最左边和最右边label会向中间缩进显示保证label全部显示在屏幕内  默认值  
        false: 显示为X轴最左边和最右边label会以与对方的坐标点中间对齐的方式显示 

K线与分时线切换

    kLineChartView.setKlineState(Status.KlineStatus klineStatus);
        参数
        Status.KlineStatus.K_LINE    : 显示K线
        Status.KlineStatus.TIME_LINE : 显示为分时线

十字线跟随手指

    kLineChartView.setCrossFollowTouch(Status.TouchCrossModel model) ;
        参数
        TouchCrossModel.FOLLOW_FIGNERS : 跟随手指
        TouchCrossModel.SHOW_CLOSE     : 显示为收盘价  默认值

动画加载加载数据时(默认是左到右的加载动画 可以加载数据前设置不使用动画)

    kLineChartView.setAnimLoadData(boolean withAnim);
        参数
        true : 执行加载数据动画  默认值
        false: 不执行加载数据动画

K线右侧内边距

    kLineChartView.setKlineRightPadding(float klineRightPadding);
        参数
        float : 内边距

设置十字线显示模式

    kLineChartView.setSelectedTouchModle(Status.ShowCrossModle showCrossModle);
        参数 
        Status.ShowCrossModle.SELECT_TOUCHE : 点击显示
        Status.ShowCrossModle.SELECTPRESS   : 长按显示
        Status.ShowCrossModle.SELECT_BOTH   : 点击长按混合

添加logo

    kLineChartView.setLogoBigmap(Bitmap bitmap);
        参数
        Bitmap : 图片Bitmap 可以设置好大后传入
    
    kLineChartView.setLogoResouce(int bitmapRes);
        参数
        bitmapRes : 资源id 原大小显示

logo透明度设置

    kLineChartView.setLogoAlpha(int alpha);
        参数
        alpha : 0-255 logo画笔透明度

logo位置是指

    kLineChartView.setLogoLeftTop(float left, float top);
        参数
        left : logo的左侧坐标,相对KlineChartView
        top  : logo的顶部坐标,相对KlineChartView

K线滑动监听

    kLineChartView.setSlidListener(SlidListener slidListener);
        参数
        slidListener : SlidListener对象 监听滑动到最左和最右

K线重置显示位置

     kLineChartView.setResetTranslate();

K线右侧可左滑的空白距离

     kLineChartView.setOverScrollRange(float overScrollRange);
        参数
        overScrollRange : 滑动距离

设置选中时是否显示十字线的交点圆

     kLineChartView.setSelectedShowCrossPoint(boolean showCrossPoint);
        参数
        true  : 显示
        false : 隐藏

选中时坐标边框线宽

     kLineChartView.setSelectedLabelBorderWidth(float width);
        参数
        width : label边框线宽 

选中时坐标边框线颜色

     kLineChartView.setSelectedLabelBorderColor(int color);
        参数
        color : 颜色值

价格线框边框宽度

     kLineChartView.setPricelineBoxBorderWidth(float width);
        参数
        width : 价格线浮框的线宽

价格线框边框颜色

     kLineChartView.setPricelineBoxBorderColor(int color);
        参数
        color : 价格线浮框的边框颜色

价格线框边框颜色

     kLineChartView.setMacdChartColor(int inColor, int deColor);
        参数
        inColor : >0 波段的颜色
        deColor : <0 波段的颜色

隐藏选择器内容

     kLineChartView.hideSelectData();
     
     隐藏选中的信息

主视图所占高度比例

     kLineChartView.setMainPercent(float mainPresent);
        参数 
        mainPresent : : 占比,用0-1之间的数表示

量视图所占高度比例

     kLineChartView.setVolPercent(float volPresent);
        参数 
        volPresent : : 占比,用0-1之间的数表示

子视图所占高度比例

     kLineChartView.setChildPercent(float childPresent);
        参数
        childPresent : 占比,用0-1之间的数表示

切换显示/隐藏交易量

     kLineChartView.setChartChildState(boolean state);
        参数
        true : 显示 
        false: 隐藏

获取当前显示/隐藏交易量

     kLineChartView.getChartChildState();

设置交易量绘制BarChart/LineChart

     kLineChartView.setVolChartStatues(Status.VolChartStatus volChartStatus);
        参数 
        null : defaul , time line show line chart , K line show barChart
        Status.VolChartStatus.BAR_CHART  : 柱状图
        Status.VolChartStatus.LINE_CHART : 线状图

功能及优化

  • 重写图例计算
  • 重写分时线绘制
  • 重写十字线绘制
  • 重写选中的绘制
  • 重写网格的绘制
  • 重写背景网格绘制
  • 重写Y轴label的绘制
  • 重写十字线纵线的绘制
  • 重写CandleLine绘制
  • 重写成交量柱状图的绘制
  • 重写数据计算
  • 重写滑动计算
  • 重写放大计算
  • 重写选中框的计算
  • 重写指标线的算法
  • 重写当前页面K线数目的计算
  • 添加深度图
  • 添加设置logo
  • 添加隐藏深度图
  • 添加k线与右侧间距
  • 添加十字线选中模式
  • 添加当前价格的时间线
  • 添加分时线尾呼吸灯效果
  • 添加追加尾部数据的方法
  • 添加时间和值的动态格式化
  • 添加K线数据变化时动画效果
  • 添加加载数据的动画执行开关
  • 添加最新价格和屏幕右侧指示线
  • 添加十字线模式开关(选中Y值跟随手指或指向最新价)
  • 添加LoadingView设置(可以自定义View并自定义动画)
  • 添加X轴左右坐标显示模式开关(相对坐标点居中,屏幕内 默认屏幕内显示)
  • 删除加载更多逻辑(重置设置数据不需要加载更多)

About

An Easy-to-Use and Perfect K-Line Library,安卓易用完善K线,Kchart,CandleLine,Kline(比特币,虚拟币,股票,外汇),指标线(MACD,WR,KDJ,RSI),ChartView

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 100.0%