Stfalcon-PriceRangeBar
Demo Application
Who we are
Need iOS and Android apps, MVP development or prototyping? Contact us via info@stfalcon.com. We develop software since 2009, and we're known experts in this field. Check out our portfolio and see more libraries from stfalcon-studio.
Download
- Add jitpack to the root build.gradle file of your project at the end of repositories.
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
- Add the dependency
dependencies {
...
implementation "com.github.stfalcon-studio:StfalconPriceRangeBar-android:[latest_version]"
}
Where the latest_version
is the value from JitPack.io.
Usage
For adding default seekbar with chart just put this code into your layout:
<com.stfalcon.pricerangebar.SeekBarWithChart
android:layout_width="match_parent"
android:layout_height="wrap_content"/>
Or you can use default rangebar with chart just put this code into your layout:
<com.stfalcon.pricerangebar.RangeBarWithChart
android:layout_width="match_parent"
android:layout_height="wrap_content"/>
After that you should to add list entries with data to displaying
val barEntrys = ArrayList<BarEntry>()
seekBarEntries.add(BarEntry(30.0f, 5.0f))
seekBarEntries.add(BarEntry(32.0f, 7.0f))
seekBarEntries.add(BarEntry(34.0f, 10.0f))
seekBarEntries.add(BarEntry(36.0f, 11.0f))
seekBarEntries.add(BarEntry(38.0f, 14.0f))
seekBarEntries.add(BarEntry(40.0f, 15.0f))
seekBar.setEntries(barEntrys)
You can use many attributes for more flexibility and convenience of use. Here's the full list:
- barActiveLineColor - color of selected part of rangebar/seekbar
- barLineColor - color of unselected part of rangebar/seekbar
- barThumbColor - color of thumb
- barActiveThumbColor - color of active radius in thumb
- barActiveTickRadius - clicked size of thumb
- barChartSelectedBackgroundColor - background color of selected part of chart
- barChartSelectedLineColor - color of selected part of top line in chart
- barChartUnSelectedLineColor - color of unelected part of top line in chart
- barChartUnselectedBackgroundColor - background color of unelected part of chart
For example:
<com.stfalcon.pricerangebar.SeekBarWithChart
android:id="@+id/seekBar"
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:barActiveLineColor="@android:color/holo_orange_dark"
app:barActiveThumbColor="@android:color/holo_blue_light"
app:barActiveTickRadius="@dimen/custom_active_tick_radius"
app:barChartSelectedBackgroundColor="@android:color/holo_red_dark"
app:barChartSelectedLineColor="@android:color/holo_green_dark"
app:barChartUnSelectedLineColor="@android:color/holo_green_light"
app:barChartUnselectedBackgroundColor="@android:color/holo_red_light"
app:barLineColor="@android:color/holo_blue_light"/>
If you want to observe any changes in seekbar you should to add callbacks like:
onPinPositionChanged
onSelectedEntriesSizeChanged
onSelectedItemsSizeChanged
If you want to observe any changes in rangebar you should to add callbacks like:
onRangeChanged
onLeftPinChanged
onRightPinChanged
onSelectedEntriesSizeChanged
onSelectedItemsSizeChanged
Let's take look a small sample for seekbar:
seekBar.onPinPositionChanged = { index, pinValue ->
println("$pinValue $index")
}
seekBar.onSelectedEntriesSizeChanged = { selectedEntriesSize ->
println("$selectedEntriesSize column was selected")
}
seekBar.onSelectedItemsSizeChanged = { selectedItemsSize ->
println("selectedItemsSize elements was selected")
}
And for rangebar:
rangeBar.onRangeChanged = { leftPinValue, rightPinValue ->
println("$leftPinValue $rightPinValue")
}
rangeBar.onLeftPinChanged = { index, leftPinValue ->
println("$index $leftPinValue")
}
rangeBar.onRightPinChanged = { index, rightPinValue ->
println("$index $rightPinValue")
}
rangeBar.onSelectedEntriesSizeChanged = { selectedEntriesSize ->
println("$selectedEntriesSize column was selected")
}
rangeBar.onSelectedItemsSizeChanged = { selectedItemsSize ->
println("$selectedItemsSize elements was selected")
}
If you want pre select some values you should use
setSelectedEntries
method.
For example:
seekBar.setSelectedEntries(30)
seekBar.setSelectedEntries(selectedEntriesSublist)
...
rangeBar.setSelectedEntries(20, 40)
rangeBar.setSelectedEntries(selectedEntriesSublist)
How to use it in Java?
We need init all views and variables
private static final String TAG = "Sample";
private ArrayList<BarEntry> seekBarEntries;
private ArrayList<BarEntry> rangeBarEntries;
private SeekBarWithChart seekBar;
private RangeBarWithChart rangeBar;
private TextView seekBarAreaInfo;
private TextView seekbarAreaValue;
private TextView rangeBarValue;
private TextView rangeBarInfo;
...
seekBar = findViewById(R.id.seekBar);
rangeBar = findViewById(R.id.rangeBar);
seekBarAreaInfo = findViewById(R.id.seekbarAreaInfo);
seekbarAreaValue = findViewById(R.id.seekbarAreaValue);
rangeBarValue = findViewById(R.id.rangeBarValue);
rangeBarInfo = findViewById(R.id.rangeBarInfo);
SeekBar
private void initSeekBar() {
seekBar.setEntries(seekBarEntries);
seekBar.setOnPinPositionChanged(this::onPinPositionChanged);
seekBar.setOnSelectedEntriesSizeChanged(this::onSelectedEntriesSizeChanged);
seekBar.setOnSelectedItemsSizeChanged(this::onSelectedItemsSizeChanged);
float perimeter = seekBarEntries.get(seekBarEntries.size() - 1).getX();
seekbarAreaValue.setText(getString(R.string.formatter_meter, Float.toString(perimeter)));
int totalSelectedSize = 0;
for (BarEntry entry : seekBarEntries) {
totalSelectedSize += entry.getY();
seekBarAreaInfo.setText(getString(R.string.formatter_elements, Float.toString(totalSelectedSize)));
}
RangeBar
private void initRangeBar() {
rangeBar.setEntries(rangeBarEntries);
rangeBar.setOnRangeChanged(this::onRangeChanged);
rangeBar.setOnLeftPinChanged(this::onLeftPinChanged);
rangeBar.setOnRightPinChanged(this::onRightPinChanged);
rangeBar.setOnSelectedEntriesSizeChanged(this::onSelectedRangeEntriesSizeChanged);
rangeBar.setOnSelectedItemsSizeChanged(this::onRangeSelectedItemsSizeChanged);
int totalSelectedSize = 0;
for (BarEntry entry : rangeBarEntries) {
totalSelectedSize += entry.getY();
}
rangeBarInfo.setText(getString(R.string.formatter_elements, Float.toString(totalSelectedSize)));
rangeBarValue.setText(
getString(
R.string.area_range,
Float.toString(rangeBarEntries.get(0).getX()),
Float.toString(rangeBarEntries.get(rangeBarEntries.size() - 1).getX())
)
);
}
Main callbacks
private Unit onPinPositionChanged(Integer index, String pinValue) {
seekbarAreaValue.setText(getString(R.string.formatter_meter, pinValue));
Log.d(TAG, "Index value = " + index);
return Unit.INSTANCE;
}
private Unit onSelectedEntriesSizeChanged(Integer selectedEntriesSize) {
Log.d(TAG, "SelectedEntriesSize = " + selectedEntriesSize);
return Unit.INSTANCE;
}
private Unit onSelectedItemsSizeChanged(Integer selectedItemsSize) {
seekBarAreaInfo.setText(getString(R.string.formatter_elements_int, selectedItemsSize));
return Unit.INSTANCE;
}
private Unit onRangeChanged(String leftPinValue, String rightPinValue) {
rangeBarValue.setText(getString(R.string.area_range, leftPinValue, rightPinValue));
return Unit.INSTANCE;
}
private Unit onLeftPinChanged(Integer index, String leftPinValue) {
Log.d(TAG, "index = " + index + " $leftPinValue = " + leftPinValue);
return Unit.INSTANCE;
}
private Unit onRightPinChanged(Integer index, String rightPinValue) {
Log.d(TAG, "index = " + index + " rightPinValue = " + rightPinValue);
return Unit.INSTANCE;
}
private Unit onSelectedRangeEntriesSizeChanged(Integer entriesSize) {
Log.d(TAG, "Range EntriesSize = " + entriesSize);
return Unit.INSTANCE;
}
private Unit onRangeSelectedItemsSizeChanged(Integer selectedItemsSize) {
rangeBarInfo.setText(getString(R.string.formatter_elements, selectedItemsSize.toString()));
return Unit.INSTANCE;
}
Unit - it is a type from package kotlin.
You can check it from full example on Java.
License
Copyright 2018 stfalcon.com
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.