Meter Number Picker

The android library that provides a simple and customizable NumberPicker styled as meter. It's based on NumberPicker.

Usage

Make sure you've added maven central to the list of your repositories at the root build.gradle:

repositories {
    mavenCentral()
}

Then add a dependency into your module's build.gradle:

dependencies {
    implementation 'com.alex-zaitsev:meternumberpicker:1.0.5'
}

Content

The library contains 2 views: MeterNumberPicker and MeterView. MeterNumberPicker is a base block for MeterView. On the screenshot above whole view is the MeterView and a single block of it is MeterNumberPicker. They are pretty simple, you can easily create your own meter class based on them.

Usage

Firstly, create a style for your number picker:

<style name="MeterNumberPickerStyle">
    <item name="mnp_min">0</item>
    <item name="mnp_max">9</item>
    <item name="mnp_textColor">@android:color/white</item>
    <item name="mnp_textSize">50sp</item>
    <item name="mnp_paddingHorizontal">5dp</item>
    <item name="mnp_paddingVertical">25dp</item>
</style>

Then, create a style for your meter view and pass the previous style:

<style name="MeterViewStyle">
    <item name="mv_firstColor">@android:color/black</item>
    <item name="mv_numberOfFirst">5</item>
    <item name="mv_numberOfSecond">1</item>
    <item name="mv_pickerStyle">@style/MeterNumberPickerStyle</item>
    <item name="mvsecondColor">@android:color/holored_dark</item>
</style>

Almost there! Now create your view and apply the style:

<com.alexzaitsev.meternumberpicker.MeterView
    android:id="@+id/meterView"
    style="@style/MeterViewStyle"
    android:layoutwidth="wrapcontent"
    android:layoutheight="wrapcontent"/>

You can use MeterNumberPicker directly without MeterView wrapper. Look at the MeterView sources to catch more details. You may also want to check the sample.

Attributes

MeterNumberPicker

|attribute name|attribute description| |:-:|:-:| |mnp_min|The min value of this widget.| |mnp_max|The max value of this widget.| |mnp_value|The current value of this widget.| |mnp_textColor|The text color of the numbers.| |mnp_textSize|The text size of the numbers.| |mnp_typeface|The typeface of the numbers.| |mnp_minWidth|The min width of this widget.| |mnp_minHeight|The min height of this widget.| |mnp_paddingHorizontal|Internal horizontal padding of this widget (left/right).| |mnp_paddingVertical|Internal vertical padding of this widget (top/bottom).|

MeterView

|attribute name|attribute description| |:-:|:-:| |mv_numberOfFirst|Number of the first-placed blocks.| |mv_numberOfSecond|Number of the second-placed blocks.| |mv_firstColor|Background color for the first-placed blocks.| |mv_secondColor|Background color for the second-placed blocks.| |mv_pickerStyle|The style for the MeterNumberPicker.| |mv_enabled|Defines whether view reacts on clicks.|

License

MeterNumberPicker is under Apache 2.0.