SimpleRangeView

SimpleRangeView is custom view component for Android, written in Kotlin, that provides for the selection of a range of discrete values designated by tick marks.

Gradle

dependencies {
  compile 'me.bendik.simplerangeview:simplerangeview:0.1.1' 
}

Basic usage	RangeView Builder

Attributes

Developers can customize the following attributes (both via XML and programmatically):

Range Attributes

Tick Attributes

Label Attributes

Thumb Attributes

Examples

Layout XML

This is a SimpleRangeView with a lower and upper value, count of ticks and fixed range

<me.bendik.simplerangeview.SimpleRangeView
  xmlns:app="http://schemas.android.com/apk/res-auto"
  android:id="@+id/fixed_rangeview"
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  app:count="10"
  app:start="3"
  app:end="6"
  app:showFixedLine="true"
  app:startFixed="2"
  app:endFixed="7"
  />

This is a SimpleRangeView with movable active range and minimal length of active range

<me.bendik.simplerangeview.SimpleRangeView
  xmlns:app="http://schemas.android.com/apk/res-auto"
  android:id="@+id/fixed_rangeview"
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  app:count="10"
  app:start="3"
  app:end="6"
  app:movable="true"
  app:minDistance="2"
  />

Adding listeners

rangeView.setOnRangeLabelsListener(new SimpleRangeView.OnRangeLabelsListener() {

  @Nullable
  @Override
  public String getLabelTextForPosition(@NotNull SimpleRangeView rangeView, int pos, @NotNull SimpleRangeView.State state) {

return String.valueOf("L" + (pos+1));

  
}
 
}
);
  rangeView.setOnTrackRangeListener(new SimpleRangeView.OnTrackRangeListener() {

  @Override
  public void onStartRangeChanged(@NotNull SimpleRangeView rangeView, int start) {

editStart.setText(String.valueOf(start));

  
}

@Override
  public void onEndRangeChanged(@NotNull SimpleRangeView rangeView, int end) {

editEnd.setText(String.valueOf(end));

  
}
 
}
);
  rangeView.setOnChangeRangeListener(new SimpleRangeView.OnChangeRangeListener() {

  @Override
  public void onRangeChanged(@NotNull SimpleRangeView rangeView, int start, int end) {

editRange.setText(String.valueOf(start) + " - " + String.valueOf(end));

  
}
 
}
);

Using Builder

final SimpleRangeView rangeView = new SimpleRangeView.Builder(this)

.count(10)

.start(2)

.end(7)

.startFixed(1)

.endFixed(8)

.showFixedLine(true)

.movable(true)

.onChangeRangeListener(this)

.onTrackRangeListener(this)

.onRangeLabelsListener(this)

.build();

Change Log

0.1.1 - Bugfixes & Handle Instance State 0.1 - Initial release 

TODO

• Get default colors from material and appcompat themes
• Handle onSaveInstanceState / onRestoreInstanceState
• Implement minimal distance between two active range labels (?)

License

Copyright (C) 2016 Vitaliy Bendik  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.