MaterialNumberPicker

KO | EN

gitlite — search

#javascript #typescript #llm #go #golang #android #machine-learning #deep-learning #docker #windows #awesome #cli #vue #awesome-list

MaterialNumberPicker

(★ 135)

A customizable number picker based on Material guidelines

파일 탐색기

최종 버전 다운로드 (.zip)

- custom_picker.png
- default_picker.png
- simple_picker.png
- .gitignore
- build.gradle
- proguard-rules.pro
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- .gitignore
- build.gradle
- proguard-rules.pro
- .gitignore
- build.gradle
- proguard-rules.pro
.editorconfig
.gitignore
build.gradle
Dangerfile
Gemfile
Gemfile.lock
gradle.properties
gradlew
gradlew.bat
ktlint.gradle
library.gradle
LICENSE
README.md
settings.gradle

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MaterialNumberPicker

[![Release](https://jitpack.io/v/StephenVinouze/MaterialNumberPicker.svg)](https://jitpack.io/#StephenVinouze/MaterialNumberPicker)
[![Build Status](https://app.bitrise.io/app/a9347fe1411caa03/status.svg?token=2_qAATk3cj48rl0eFYGE1A&branch=master)](https://www.bitrise.io/app/a9347fe1411caa03)
[![API](https://img.shields.io/badge/API-11%2B-brightgreen.svg?style=flat)](https://android-arsenal.com/api?level=11)
[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-MaterialNumberPicker-brightgreen.svg?style=flat)](https://android-arsenal.com/details/1/6250)
[![GitHub license](http://img.shields.io/badge/license-APACHE2-blue.svg)](https://github.com/StephenVinouze/AdvancedRecyclerView/blob/master/LICENSE)

This library takes over the [repository](https://github.com/KasualBusiness/MaterialNumberPicker) that I originally created and passed on but seems no longer maintained. It was ported in Kotlin to provide clearer and more optimized code, and includes various features that are still pending in the previous library. It also provides optionals and nullables with a custom constructor so that you can customize your picker the way you want without using a verbose builder pattern.

Native NumberPicker | MaterialNumberPicker (default) | MaterialNumberPicker (custom)
---- | ---- | ----
![Default picker](https://raw.githubusercontent.com/StephenVinouze/MaterialNumberPicker/master/art/default_picker.png) | ![Simple picker](https://raw.githubusercontent.com/StephenVinouze/MaterialNumberPicker/master/art/simple_picker.png) | ![Custom picker](https://raw.githubusercontent.com/StephenVinouze/MaterialNumberPicker/master/art/custom_picker.png)

## Gradle Dependency

Add this in your root `build.gradle` file:

```gradle
allprojects {
    repositories {
	maven { url "https://jitpack.io" }
    }
}
```

Then add the dependencies that you need in your project.

```gradle
dependencies {
    compile "com.github.StephenVinouze:MaterialNumberPicker:{latest_version}"
}
```

## Usage

Both XML and programmatic instanciations are supported :

```xml
<com.github.stephenvinouze.materialnumberpickercore.MaterialNumberPicker
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:mnpMaxValue="50"
    app:mnpMinValue="1"
    app:mnpEditable="false"
    app:mnpFontname="Hand.ttf"
    app:mnpSeparatorColor="@color/colorAccent"
    app:mnpTextColor="@color/colorPrimary"
    app:mnpTextSize="16sp"
    app:mnpTextStyle="bold"
    app:mnpValue="10"
    app:mnpWrapped="false" />
```

```kotlin
val numberPicker = MaterialNumberPicker(
    context = this,
    minValue = 1,
    maxValue = 50,
    value = 10,
    separatorColor = ContextCompat.getColor(this, R.color.colorAccent),
    textColor = ContextCompat.getColor(this, R.color.colorPrimary),
    textSize = resources.getDimensionPixelSize(R.dimen.numberpicker_textsize),
    textStyle = Typeface.BOLD_ITALIC,
    editable = false,
    wrapped = false,
    fontName = "Hand.ttf",
    formatter = NumberPicker.Formatter {
        return@Formatter "Value $it"
    }
)
```

For Java users, I have overloaded the constructor so that it generates all possible constructors.

```java
MaterialNumberPicker numberPicker = new MaterialNumberPicker(
    this,
    1,
    50,
    10,
    ContextCompat.getColor(this, R.color.colorAccent),
    ContextCompat.getColor(this, R.color.colorPrimary),
    getResources().getDimensionPixelSize(R.dimen.numberpicker_textsize),
    Typeface.BOLD_ITALIC,
    false,
    false,
    "Hand.ttf",
    new NumberPicker.Formatter() {
        @Override
        public String format(int i) {
            return "Value " + i;
        }
    }
);
```

I have arranged the parameters in priority order but it is not as ideal as with Koltin because you can't name the attributes nor change their orders. However, all attributes are exposed with getter/setters so you can easily set the desired attributes after instanciating the picker with the default constructor.

```java
MaterialNumberPicker numberPicker = new MaterialNumberPicker(this);
numberPicker.setTextColor(ContextCompat.getColor(this, R.color.colorPrimary));
```

Once you have your number picker, you can present it by itself, or within an alert dialog :

```kotlin
AlertDialog.Builder(this)
    .setTitle(title)
    .setView(numberPicker)
    .setNegativeButton(getString(android.R.string.cancel), null)
    .setPositiveButton(getString(android.R.string.ok), { _, _ ->
        Toast.makeText(this, getString(R.string.picker_value, numberPicker.value), Toast.LENGTH_LONG).show()
    })
    .show()
```

The only attribute that cannot be defined through XML is the formatter that is natively included in the `NumberPicker`. It can be directly assigned from the custom constructor when instanciating programmaticaly. Note that all attributes have their own getter/setters and can be upcated anytime durnig your view's lifecycle.
 
We also provide a way to define either your text style within the picker or a custom font. Be aware though that once you define a custom font, the text style will be overriden by the custom font and won't be interpreted.

## Pull requests

I welcome and encourage all pull requests. I might not be able to respond as fast as I would want to but I endeavor to be as responsive as possible.

All PR must:

1. Be written in Kotlin
2. Maintain code style
3. Indicate whether it is a enhancement, bug fix or anything else
4. Provide a clear description of what your PR brings
5. Enjoy coding in Kotlin :)

MaterialNumberPicker

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

MaterialNumberPicker

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README