Skip to content

Latest commit

 

History

History
255 lines (187 loc) · 7.01 KB

README.md

File metadata and controls

255 lines (187 loc) · 7.01 KB

NumberPicker

Build Status Maven Central Android Arsenal

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