MPAndroidChart简单使用

所有演示都采用 MPAndroidChart v3.1.0

 

官方地址:https://github.com/PhilJay/MPAndroidChart

 

首先要感谢作者写出这么强大的图表控件让我们免费使用,如果您条件匀许可以a coffee (or some beer) for him。

 

工作中,经常会用到图表控件,以直观的方式来给用户感性的认识,可以是门店销量比对,可以是门店的日月报表,也可以是会员消费的排行等等。

 

工欲善其事,必先利其器。

好的工具,不会用,也是枉然。

然而,好的东西肯定有它一定的使用方法,如何简单的使用,那就需要有人尝试,有人研究。

然后结果证明,使用往往是简单的,但是不了解的时候,会花费大量的时间与精力,到最好可能也就是一行代码的事。

这也是我来写这个的初衷吧。

 

这里我来讲一下我们在工作中实际业务中,是如何来处理这个报表控件的。

 1、先来了解下它

 

 

 

以上的截图是官方提供的例子,这个很重要,因为他给我们提供了很大的帮助,好多都可以直接搬过来用,不需要再去看文档。

其中包括:Line Charts折线图 Bar Charts柱状图 Pie Charts饼图 Other Charts其它……

1)如何打开这个例子:

我使用的是Android Studio 3.5.3 , 前段时间刚刚升级,其实如果是维护产品的话,升级不升级,还要看情况。

有个前提:在使用第三方提供的Lib的时候,我们得跟上这个源程序的Lib,好多时候,我们一转眼,有些项目就升级了,原来的API就不存在了,或者在网上找了一堆关于这个第三方控件的,因为版本的问题,根本就用不上,当你比较着急做项目的时候,特别是加班,我想如果你做过几年开发,那肯定是有心德体会的。

打开Android Studio, File -- Open

 

打开后,会有些jar的下载过程,稍等下,在这里,我碰到了很多问题,大体上是握手没有通过,后来找了下,才知道是我开了防火墙。关了重新打开就可以,稍等下,一切都会OK。

打开后,我们会发现有二个Modules

 

 一个是Example(例子),另一个是Lib(提供API)

点击 “运行” 就可以安装到手机上,或者模拟器上,我一般在真机上测试。

好了,到此例子就运行了,有兴趣可以自已先看一下。

2)我们来看看一个图表,大概有几部分组成

v 先上一张图,也就是例子中的第一张图

 

 

这是个折线图,有X轴,Y轴(一般左右各一个,这里右边的Y轴隐藏了),Legend, Limit Line。

x轴:chart.getXAxis();  chart代表是图表对象,x轴可以设置在上,还是在下显示。

XAxis xl = chart.getXAxis();
xl.setPosition(XAxisPosition.BOTTOM);

这里设置显示在下方。

 

y轴:

YAxis yl = chart.getAxisLeft();左侧的Y轴。

YAxis yr = chart.getAxisRight();右侧的Y轴。

 

Legend:说明区别各个图表类型特定的设置,比如说各个门店的对比,我们可以自定义这个Legend来加一个适合我们项目的说明。

 

这里的门店就是Legend区域。

 

Limit Line:  限制线;极限线;界线 , 比如说我们要写一个产品合格率的,这个就挺不错的,到哪是合格,那是不合格的,这样一目了然。

图中的虚线Upper Limit,Lower Limit就是一个Limit Line ,当然样式也是可以自定义的

 

 

2、实例中我们是如何来使用的

1)一般我们在做项目的时候,都会有步骤,我们来看一下加入图表一般有几个步骤

2)步骤

u XML中加入这个控件

<com.github.mikephil.charting.charts.HorizontalBarChart
    android:id="@+id/chart1"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@android:color/white"
    android:layout_above="@+id/seekBar1" />

u 代码中我们要拿到这个控件

private HorizontalBarChart chart;

 

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);        

chart = findViewById(R.id.chart1);
          chart.setOnChartValueSelectedListener(this);    

……

}

 

u 对这个控件作一些设置,这步完成以后,大体的框架出来了

  //在图表上显示值
        chart.setDrawValueAboveBar(true);
    //不显示图表中的说明
        chart.getDescription().setEnabled(false);

        // if more than 60 entries are displayed in the chart, no values will be
        // drawn
        chart.setMaxVisibleValueCount(60);

        // scaling can now only be done on x- and y-axis separately
        chart.setPinchZoom(false);

        // draw shadows for each bar that show the maximum value
        // chart.setDrawBarShadow(true);

        chart.setDrawGridBackground(false);
       //x轴
        XAxis xl = chart.getXAxis();
        xl.setPosition(XAxisPosition.BOTTOM);
        xl.setTypeface(tfLight);
        xl.setDrawAxisLine(true);
        xl.setDrawGridLines(false);
        xl.setGranularity(10f);

//y轴 左侧
        YAxis yl = chart.getAxisLeft();
        yl.setTypeface(tfLight);
        yl.setDrawAxisLine(true);
        yl.setDrawGridLines(true);
        yl.setAxisMinimum(0f); // this replaces setStartAtZero(true)
//        yl.setInverted(true);


//y轴 左侧
        YAxis yr = chart.getAxisRight();
        yr.setTypeface(tfLight);
        yr.setDrawAxisLine(true);
        yr.setDrawGridLines(false);
        yr.setAxisMinimum(0f); // this replaces setStartAtZero(true)
//        yr.setInverted(true);

 

u 给图表一个数据,让其能显示出来

ArrayList<Entry> values = new ArrayList<>();

for (int i = 0; i < count; i++) {

    float val = (float) (Math.random() * range) - 30;
    values.add(new Entry(i, val, getResources().getDrawable(R.drawable.star)));
}

LineDataSet set1;

 

if (chart.getData() != null &&
        chart.getData().getDataSetCount() > 0) {
    set1 = (LineDataSet) chart.getData().getDataSetByIndex(0);
    set1.setValues(values);
    set1.notifyDataSetChanged();
    chart.getData().notifyDataChanged();
    chart.notifyDataSetChanged();
} else {
    // create a dataset and give it a type
    set1 = new LineDataSet(values, "DataSet 1");

}

如果存在dataset,那么直接赋值,如果不存在,那么新建一个。

 

加到数据到DataSet , 展示数据

ArrayList<ILineDataSet> dataSets = new ArrayList<>();
dataSets.add(set1); // add the data sets
这里可以增加多条折线,只要有多个数据,多个LineDataSet即可。
// create a data object with the data sets
LineData data = new LineData(dataSets);

// set data
chart.setData(data);

 

这样我们基本上是有个概念了,为下面的实例来作准备。

posted @ 2020-03-01 09:09  jiduoduo  阅读(1709)  评论(0编辑  收藏  举报