NumberPicker
A simple customizable NumberPicker for Android.
Installation
via Gradle:
compile 'com.github.travijuu:numberpicker:1.0.7'
or Maven:
<dependency>
<groupId>com.github.travijuu</groupId>
<artifactId>numberpicker</artifactId>
<version>1.0.7</version>
<type>aar</type>
</dependency>
Usage
Add NumberPicker component in your XML layout
activity_main.xml
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
xmlns:numberpicker="http://schemas.android.com/apk/res-auto"
tools:context="com.travijuu.numberpicker.sample.MainActivity">
<com.travijuu.numberpicker.library.NumberPicker
android:id="@+id/number_picker"
android:layout_width="130dp"
android:layout_height="40dp"
numberpicker:min="0"
numberpicker:max="10"
numberpicker:value="-5"
numberpicker:unit="1"
numberpicker:focusable="false"
numberpicker:custom_layout="@layout/number_picker_custom_layout" />
</LinearLayout>
MainActivity.java
import com.travijuu.numberpicker.library.NumberPicker;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
NumberPicker numberPicker = (NumberPicker) findViewById(R.id.number_picker);
numberPicker.setMax(15);
numberPicker.setMin(5);
numberPicker.setUnit(2);
numberPicker.setValue(10);
}
}
XML Attributes
| Name | Type | Default |
|---|---|---|
| min | int | 0 |
| max | int | 999999 |
| value | int | 1 |
| unit | int | 1 |
| focusable | boolean | false |
| custom_layout | layout | @layout/number_picker_layout |
Layout Customization
if you want to customize your NumberPicker layout you can create your own.
IMPORTANT! This layout should contains at least 3 items with given Ids:
- Button (@+id/increment)
- Button (@+id/decrement)
- TextView (@+id/display)
Note: You can see an example layout in both sample and library modules.
Example XML layout:
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="130dp"
android:layout_height="40dp"
android:orientation="horizontal"
android:background="@android:color/white">
<Button
android:layout_width="30dp"
android:layout_height="match_parent"
android:padding="0dp"
android:textColor="@android:color/black"
android:background="@null"
android:id="@+id/decrement"
android:textStyle="bold"
android:text="—"/>
<TextView
android:layout_width="70dp"
android:background="@android:color/white"
android:layout_height="match_parent"
android:text="1"
android:textColor="@android:color/black"
android:inputType="number"
android:id="@+id/display"
android:gravity="center"
/>
<Button
android:layout_width="30dp"
android:layout_height="match_parent"
android:padding="0dp"
android:textSize="25sp"
android:textColor="@android:color/black"
android:background="@null"
android:id="@+id/increment"
android:text="+"/>
</LinearLayout>
Methods
Here is the list of methods with definitions.
setMin(int value)
Sets minimum value allowed
getMin()
Gets minimum value
setMax(int value)
Sets maximum value allowed
getMax()
Gets maximum value allowed
setUnit(int value)
Sets unit value for increment/decrement operation
getUnit()
Gets unit value
setValue(int value)
Sets NumberPicker current value
getValue()
Gets NumberPicker current value
setActionEnabled(ActionEnum action, boolean enabled)
Enables or disables Increment/Decrement buttons
setDisplayFocusable(boolean focusable)
Enables or disables NumberPicker editable via keyboard
increment()
NumberPicker will be incremented by defined unit value
increment(int unit)
NumberPicker will be incremented by given unit value
decrement()
NumberPicker will be decremented by defined unit vale
decrement(int unit)
NumberPicker will be decremented by given unit value
refresh()
NumberPicker will be refreshed with already defined value
clearFocus()
NumberPicker will lose the focus
valueIsAllowed(int value)
Checks whether given value is acceptable or not
setLimitExceededListener(LimitExceededListener limitExceededListener)
setValueChangedListener(ValueChangedListener valueChangedListener)
setOnEditorActionListener(OnEditorActionListener onEditorActionListener)
setOnFocusChangeListener(OnFocusChangeListener onFocusChangeListener)
Listeners
LimitExceededListener
This is triggered when you try to set lower or higher than the given min/max limits
public class DefaultLimitExceededListener implements LimitExceededListener {
public void limitExceeded(int limit, int exceededValue) {
String message = String.format("NumberPicker cannot set to %d because the limit is %d.", exceededValue, limit);
Log.v(this.getClass().getSimpleName(), message);
}
}
ValueChangedListener
This is triggered when the NumberPicker is incremented or decremented.
Note: setValue method will not trigger this listener.
public class DefaultValueChangedListener implements ValueChangedListener {
public void valueChanged(int value, ActionEnum action) {
String actionText = action == ActionEnum.MANUAL ? "manually set" : (action == ActionEnum.INCREMENT ? "incremented" : "decremented");
String message = String.format("NumberPicker is %s to %d", actionText, value);
Log.v(this.getClass().getSimpleName(), message);
}
}
OnEditorActionListener
This is triggered when you click "done" button on keyboard after you edit current value.
Note: "done" button can be changed on xml so this listener should be overrided according to new IME option.
OnFocusChangeListener
This is triggered when clearFocus() is called which helps to set new value when the focus lost
4.4k Dec 30, 2022
399 Dec 29, 2022
881 Dec 30, 2022
162 Dec 2, 2022
2.1k Dec 31, 2022
628 Sep 24, 2022
90 Dec 15, 2022
2.7k Jan 2, 2023
96 Nov 1, 2022
151 Jul 26, 2022
79 Nov 22, 2022
71 Dec 5, 2021
78 Sep 20, 2022
29 Jun 8, 2022
2.3k Dec 31, 2022
6k Jan 7, 2023
1.3k Nov 15, 2022