SpinnerDatePicker

Additional

Language
Java
Version
0.1.0 (Nov 15, 2017)
Created
Nov 7, 2017
Updated
Nov 18, 2017
Owner
SunHKM Factory (HKMOpen)
Contributors
世外桃源 KPT-D (jjhesk)
Mike Wolfson (mwolfson)
David Rawson (drawers)
3
Activity
Badge
Generate
Download
Source code
APK file

Advertising

Spinner DatePicker

Summary

The old "spinner" style DatePicker for newer devices.

Motivation

The default Material Design DatePicker has poor usability for choosing a date of birth. It seems it is hard for users to find the "year" button and they will often simply swipe left or right through the months in order to find their date of birth.

The previous Holo DatePicker with sliding NumberPickers is much more suitable for this use case however it is no longer available for Marshmallow devices and up.

This library is heavily based on the open source Contacts App DatePicker (source code here) with the addition of being able to style the NumberPickers (the dials/spinners in the DatePicker).

  • optional year
  • date format
  • support API 26.1.0
  • Android 4.4+

Adding styles

The DatePicker is the simple aggregation of three NumberPickers. You can style the DatePicker easily with a NumberPicker style:

<style name="NumbePickerStyle">
    <item name="android:textSize">22dp</item>
    <item name="android:textColorPrimary">@color/colorAccent</item>
    <item name="android:colorControlNormal" tools:targetApi="lollipop">@color/colorAccent</item>
</style>

where colorControlNormal is the color of the horizontal bars (dividers) in the NumberPicker. See this StackOverflow question

And then:

    new SpinnerDatePickerDialogBuilder()
            .context(MainActivity.this)
            .callback(MainActivity.this)
            .spinnerTheme(spinnerTheme)
            .year(year)
            .monthOfYear(monthOfYear)
            .dayOfMonth(dayOfMonth)
            .build()
            .show();

The example project should make it clear - get it by cloning the repo.

Usage in a project

Add the following to your project level build.gradle:

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

Add this to your app level build.gradle:

dependencies {
    implementation 'com.hkm.ui:spinner-date-picker:0.1.0'
}

Philosophy

The aim of this project is to produce a lightweight and robust DatePicker. Hence the library has no external dependencies and no fancy features. Espresso automated UI pesting is performed on the sample project using Firebase test lab. When more funds are available, more devices will be tested.

License

Copyright 2017 David Rawson, JJHESK

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.

Thank you for your support and we will bring more amazing libraries to your productive works. We are accepting bitcoin by the address as below. Please scan the QR code to start