A Blog to Write about Everything

0%

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

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

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

APP 里实现的最终效果:

引入框架

首先是引入框架:

https://github.com/PhilJay/MPAndroidChart

Gradle设置一下:

1
2
3
4
5
6
7
repositories {
maven { url 'https://jitpack.io' }
}

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

LineChart 折线图

显示数据

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

  1. XML 布局文件内加入:
1
2
3
4
<com.github.mikephil.charting.charts.LineChart
android:id="@+id/line_chart"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
  1. Entry,Entry 可以理解为一个点,赋值 x 和 y 数值。
1
2
3
4
5
6
val lineEntries = ArrayList<Entry>()

for ((i, e) in countList.withIndex()) {
val entry = Entry(i.toFloat(), e.toFloat())
lineEntries.add(entry)
}
  1. LineDataSet,可以理解为一条线。
1
val lineDataSet = LineDataSet(lineEntries, "")
  1. LineData,可以理解为多条线的集合。
1
2
3
4
5
val lineData = LineData(lineDataSet)
view.line_chart.data = lineData

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

然后你会得到:

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


设置样式

  1. 设置LineDataSet的样式。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
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
}
  1. 设置 X 轴的样式。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
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()]
}
}
  1. 设置左侧 Y 轴的样式。(同理 x 轴)
1
2
3
4
val yAxis = view.line_chart_exp.axisLeft
yAxis.granularity = 1f
// 如果你的y轴数值是正数的话,建议最小值为0,因为默认的话会略小于0。
yAxis.axisMinimum = 0f
  1. 图表的样式设置。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
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

样式设置也差不多,就直接贴代码了:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
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

完整代码:

1
2
3
4
5
6
7
8
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. 首先是设置颜色。
1
2
3
4
5
6
// 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
  1. PieDataSet设置饼块间隔、数值字体大小。
1
2
pieDataSet.sliceSpace = 3.0f
pieDataSet.valueTextSize = 9.0f
  1. PieData设置数值以百分比显示和字体颜色。
1
2
3
// 设置ValueFormatter让数值变成百分号(%)形式显示,但是数值还是原来的0.x
pieData.setValueFormatter(PercentFormatter())
pieData.setValueTextColor(ContextCompat.getColor(it, R.color.white))
  1. PieChart的样式设置。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
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文档