Skip to content

A powerful 🚀 Android range bar chart library as well as scaling, panning and animations.

Notifications You must be signed in to change notification settings

ParkSangGwon/RangeBarChart

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.```

About

A powerful 🚀 Android range bar chart library as well as scaling, panning and animations.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages