本文讲讲怎么用 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折线图
显示数据
首先,先让我们的图标正确显示数据吧~
- XML 布局文件内加入:
<com.github.mikephil.charting.charts.LineChart
android:id="@+id/line_chart"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
- Entry,Entry 可以理解为一个点,赋值 x 和 y 数值。
val lineEntries = ArrayList<Entry>()
for ((i, e) in countList.withIndex()) {
val entry = Entry(i.toFloat(), e.toFloat())
lineEntries.add(entry)
}
- LineDataSet,可以理解为一条线。
val lineDataSet = LineDataSet(lineEntries, "")
- LineData,可以理解为多条线的集合。
val lineData = LineData(lineDataSet)
view.line_chart.data = lineData
// 填充数据后要重绘图表
view.line_chart.invalidate()
然后你会得到:
嗯,默认样式有点丑。接下来就是修改样式了。
设置样式
- 设置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
}
- 设置 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()]
}
}
- 设置左侧 Y 轴的样式。(同理 x 轴)
val yAxis = view.line_chart_exp.axisLeft
yAxis.granularity = 1f
// 如果你的y轴数值是正数的话,建议最小值为0,因为默认的话会略小于0。
yAxis.axisMinimum = 0f
- 图表的样式设置。
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 柱形图
柱形图与折线图类似,只是:
- Entry 变成了 BarEntry
- LineDataSet 变成了 BarDataSet
- LineData 变成了 BarData
- 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 饼图
填充数据
依旧类似:
- Entry 变成了 PieEntry
- LineDataSet 变成了 PieDataSet
- LineData 变成了 PieData
- 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,要不然可能显示不正常。
然后你会得到一块效果很丑的饼:
可以看到所有每一块的颜色都是相同的,图例也只显示了一个,并且所有饼块都紧邻在了一起,右下角的描述也需要去掉,冰块上方的数字应该改成百分比显示。
设置样式
- 首先是设置颜色。
// 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
- PieDataSet设置饼块间隔、数值字体大小。
pieDataSet.sliceSpace = 3.0f
pieDataSet.valueTextSize = 9.0f
- PieData设置数值以百分比显示和字体颜色。
// 设置ValueFormatter让数值变成百分号(%)形式显示,但是数值还是原来的0.x
pieData.setValueFormatter(PercentFormatter())
pieData.setValueTextColor(ContextCompat.getColor(it, R.color.white))
- 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文档的介绍。