Skip to content

Latest commit

 

History

History
163 lines (132 loc) · 4.87 KB

README.md

File metadata and controls

163 lines (132 loc) · 4.87 KB
Raw

RangeBarChart

⚡ Range bar chart library for Android using MPAndroidChart⚡

  • There were no charts in MPAndroidChart to show ranges.
  • We were forced to show the range charts we wanted using a similarly capable candlestick chart.
  • This library can be used when you want to create charts that can represent ranges such as weather and heart rate.
Default Min/Max Draw Label


Demo



Setup

Gradle

Maven Central

repositories {
  google()
  mavenCentral()
  maven { url 'https://jitpack.io' } // For using MPAndroidChart
}

dependencies {
    implementation 'io.github.ParkSangGwon:range-bar-chart:x.y.z'
    //implementation 'io.github.ParkSangGwon:range-bar-chart:0.0.6'
}

If you think this library is useful, please press star button at upside.



How to use

  • The usage of this library is perfectly consistent with that of MPAndroidChart
  • Please read official document
  • A detailed explanation can be understood immediately by looking at the code of the sample project.

RangeBarEntry

  • min
  • max

Setup Chart

private fun RangeBarChart.setup() {
    setScaleEnabled(false)
    setDrawGridBackground(false)
    setBackgroundColor(Color.TRANSPARENT)
    description.isEnabled = false
    xAxis.apply {
        position = XAxis.XAxisPosition.BOTTOM
        setDrawGridLines(false)
    }
    axisLeft.apply {
        setDrawGridLines(false)
        axisMinimum = -20f
        axisMaximum = 40f
    }
    axisRight.isEnabled = false
    legend.isEnabled = false
    data = RangeBarData(createSet())
}

Create DataSet

RangeBarDataSet(null, "RangeBar").apply {
    color = Color.parseColor("#2BDD9E")
    barWidth = 0.4f
    isHighlightEnabled = true
    highLightColor = Color.CYAN
    minColor = Color.parseColor("#22BCFE")
    maxColor = Color.parseColor("#FC351E")
    setDrawValues(false)
    valueTextSize = 12f
    valueFormatter = object : ValueFormatter() {
        override fun getFormattedValue(value: Float): String = "${value.toInt()}°C"
    }
}

Add your entries

private fun getWeatherEntries(): List<RangeBarEntry> {
    val values = mutableListOf<RangeBarEntry>()
    values.add(RangeBarEntry(1f, -7f, 1f))
    values.add(RangeBarEntry(2f, -4f, 4f))
    values.add(RangeBarEntry(3f, 2f, 11f))
    values.add(RangeBarEntry(4f, 8f, 18f))
    values.add(RangeBarEntry(5f, 14f, 23f))
    values.add(RangeBarEntry(6f, 19f, 26f))
    values.add(RangeBarEntry(7f, 23f, 28f))
    values.add(RangeBarEntry(8f, 25f, 33f))
    values.add(RangeBarEntry(9f, 17f, 25f))
    values.add(RangeBarEntry(10f, 10f, 18f))
    values.add(RangeBarEntry(11f, 3f, 11f))
    values.add(RangeBarEntry(12f, -3f, 4f))
    return values
}
private fun RangeBarChart.addData() {
    val data = data ?: return
    val rangeBarDataSet = data.getDataSetByIndex(0) ?: return
    val values = getWeatherEntries()
    rangeBarDataSet.values = values
    data.notifyDataChanged()
    notifyDataSetChanged()
}



Customize

RangeBarDataSet

variable Description
barWidth Adjust board width
minColor Min color int
maxColor Max color int

FAQ

Can I use BarChart's function/variable?

  • Yes, RangeBarChart is a class implemented by inheriting from BarChart.
  • So you can use all the features that BarChart uses.

How is it different from candlestick charts?

  • Candle charts must specify a starting and ending point as well as a minimum and maximum.
  • It is used for the purpose of using stock charts, not to display only the range we want.
  • RangeBarChart only shows the minimum and maximum ranges.



License

Copyright 2022 Ted Park

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.```