人升开发日志#12 | 01/17 图表

本文讲讲怎么用 MPAndroidChart 框架实现折线图、柱形图、饼图，并且进行样式设置，达到和宣传图差不多的效果。

一开始看到 MPAndroidChart 的各种图表介绍图感觉很好看，但是直接New一个相应图表，仅仅填充数据的话，样式稍微有些丑。经过一番阅览文档才把样式调整得好看些。所以就写了这篇文章记录下。

APP 里实现的最终效果：

引入框架

首先是引入框架：

https://github.com/PhilJay/MPAndroidChart

Gradle设置一下：

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    implementation 'com.github.PhilJay:MPAndroidChart:v3.1.0-alpha'
}

LineChart 折线图

显示数据

首先，先让我们的图标正确显示数据吧~

1. XML 布局文件内加入：

<com.github.mikephil.charting.charts.LineChart
     android:id="@+id/line_chart"
     android:layout_width="match_parent"
     android:layout_height="match_parent"/>

2. Entry，Entry 可以理解为一个点，赋值 x 和 y 数值。

val lineEntries = ArrayList<Entry>()

for ((i, e) in countList.withIndex()) {
    val entry = Entry(i.toFloat(), e.toFloat())
    lineEntries.add(entry)
}

3. LineDataSet，可以理解为一条线。

val lineDataSet = LineDataSet(lineEntries, "")

4. LineData，可以理解为多条线的集合。

val lineData = LineData(lineDataSet)
view.line_chart.data = lineData

// 填充数据后要重绘图表
view.line_chart.invalidate()

然后你会得到：

嗯，默认样式有点丑。接下来就是修改样式了。

设置样式

1. 设置LineDataSet的样式。

lineDataSet.apply{
    // 不在坐标点上显示 y 数值
    setDrawValues(false)
    /* 改为曲线显示模式，一共有四种显示模式：
        LINEAR,STEPPED,CUBIC_BEZIER,HORIZONTAL_BEZIER
    */
    mode = LineDataSet.Mode.HORIZONTAL_BEZIER
    // 改变线条颜色
    color = resources.getColor(R.color.blue)
    // 不显示相应坐标点的小圆圈
    setDrawCircles(false)
    setDrawCircleHole(false)
    // 设置线的宽度
    lineWidth = 1.5f
}

2. 设置 X 轴的样式。

val xAxis = view.chart.xAxis
// 这里的listStringDatePastDays方法的功能是获取近7天的日期字符串数组
val stringDateList = DateUtil.listStringDatePastDays(7)

xAxis.apply{
    // 取消网格线显示
    setDrawGridLines(false)
    // 位置改到图表下方
    position = XAxis.XAxisPosition.BOTTOM
    // x轴起始改为0
    axisMinimum = 0f
    // x轴的最小单位设置为1f
    granularity = 1f
    // 改变x轴的显示内容，
    // 然后设置valueFormatter将x轴的数值对应上日期，然后实际上就会显示日期了。
    valueFormatter = IAxisValueFormatter { value, axis ->
        stringDateList[value.toInt()]
    }
}

3. 设置左侧 Y 轴的样式。（同理 x 轴）

val yAxis = view.line_chart_exp.axisLeft
yAxis.granularity = 1f
// 如果你的y轴数值是正数的话，建议最小值为0，因为默认的话会略小于0。
yAxis.axisMinimum = 0f

4. 图表的样式设置。

view.chart.apply{
    // 禁用图例
    legend.isEnabled = false
    // 禁用触摸响应
    setTouchEnabled(false)
    // 禁用右侧的y轴
    axisRight.isEnabled = false
    // 取消右下角的Description Label
    description.isEnabled = false
    // 取消背景的网格绘制
    setDrawGridBackground(false)
    // 没有数据的时候显示的文本内容
    setNoDataText("暂时没有相应数据")
    // 设置动画效果
    animateY(1000, Easing.Linear)
    animateX(1000, Easing.Linear)
}

然后就能得到这样的效果：

BarChart 柱形图

柱形图与折线图类似，只是：

1. Entry 变成了 BarEntry
2. LineDataSet 变成了 BarDataSet
3. LineData 变成了 BarData
4. LineChart 变成了 BarChart

样式设置也差不多，就直接贴代码了：

private fun initStepBarChart(view: View) {
    val barEntries = ArrayList<BarEntry>()
    val stepList = stepService.listFinishTaskCountPastDays(7)
    for ((i, e) in stepList.withIndex()) {
        val entry = BarEntry(i.toFloat(), e.toFloat())
        barEntries.add(entry)
    }
    val barDataSet = BarDataSet(barEntries, "")
    context?.let { barDataSet.color = (ContextCompat.getColor(it, R.color.color_bar_chart)) }
    barDataSet.setDrawValues(true)
    val barData = BarData(barDataSet)
    val xAxisOfBarData = view.bar_chart_step.xAxis
    val stringDateList = DateUtil.listStringDatePastDays(7)
    xAxisOfBarData.apply {
        valueFormatter = IAxisValueFormatter { value, axis ->
            stringDateList[value.toInt()]
        }
        position = XAxis.XAxisPosition.BOTTOM
        //xAxisOfBarData.setDrawAxisLine(false)
        setDrawGridLines(false)
    }
    val yAxisOfBarData = view.bar_chart_step.axisLeft
    yAxisOfBarData.apply {
       axisMinimum = 0f
       setDrawGridLines(false)
    }

    view.bar_chart_step.apply {
        legend.isEnabled = false
        data = barData
        description.isEnabled = false
        setDrawGridBackground(false)
        axisRight.isEnabled = false
        animateY(1000, Easing.Linear)
        animateX(1000, Easing.Linear)
        setNoDataText("暂时没有相应数据")
        invalidate()
    }
}

PieChart 饼图

填充数据

依旧类似：

1. Entry 变成了 PieEntry
2. LineDataSet 变成了 PieDataSet
3. LineData 变成了 PieData
4. LineChart 变成了 PieChart

完整代码：

val pieEntries = ArrayList<PieEntry>()
pieEntries.add(PieEntry(0.3, "Pie1"))
pieEntries.add(PieEntry(0.5, "Pie2"))
pieEntries.add(PieEntry(0.2, "Pie3"))
val pieDataSet = PieDataSet(pieEntries, "")
val pieData = PieData(pieDataSet)
view.pie_chart_exp.data = pieData
view.pie_chart_exp.invalidate()

稍微注意一点的地方是，PieEntry没有x、y值，只有一个value占比数值。

所有PieEntry的Value总和应该为1，要不然可能显示不正常。

然后你会得到一块效果很丑的饼：

可以看到所有每一块的颜色都是相同的，图例也只显示了一个，并且所有饼块都紧邻在了一起，右下角的描述也需要去掉，冰块上方的数字应该改成百分比显示。

设置样式

1. 首先是设置颜色。

// pieColors的颜色会与pieEntries一一对应
val pieColors = ArrayList<Int>()
pieColors.add(ContextCompat.getColor(context,R.color.red))
pieColors.add(ContextCompat.getColor(context,R.color.green))
pieColors.add(ContextCompat.getColor(context,R.color.blue))
pieDataSet.colors = pieColors

2. PieDataSet设置饼块间隔、数值字体大小。

pieDataSet.sliceSpace = 3.0f
pieDataSet.valueTextSize = 9.0f

3. PieData设置数值以百分比显示和字体颜色。

// 设置ValueFormatter让数值变成百分号（%）形式显示，但是数值还是原来的0.x
pieData.setValueFormatter(PercentFormatter())
pieData.setValueTextColor(ContextCompat.getColor(it, R.color.white))

4. PieChart的样式设置。

view.pie_chart_exp.apply{
    // 设置以百分比显示，这里是指将原来的0.x乘100，并不会加上“%”符号
    setUsePercentValues(true)
    // 设置Label的字体大小（比如上方的Pie1）
    setEntryLabelTextSize(10.0f)
    // 设置中间的文本显示
    centerText = "经验分布"
    // 去掉右下角的Description
    description.isEnabled = false
    setNoDataText("暂时没有相应数据")
    // 开启动画效果
    animateY(1000, Easing.Linear)
    animateX(1000, Easing.Linear)
}

至此，饼图已经变得挺好看了：

当然，你还能进行更多的样式调整，可以参考官方Github Wiki和API文档的介绍。

官方文档

WIKI使用教程

详细API文档