DialogFragments modeled after the AOSP Clock and Calendar apps to improve UX for picking time, date, numbers, and other things.

Try out the sample application on Google Play.

Changelog

1.5.3

allow proper use of appcompat 21
added a few translations
first release made from the new support team (Code-Troopers)

1.5.2

Bugfix for Gradle resource processing Switch backport attrs.

1.5.1

Package assets in library since we are now producing an .aar

1.5.0

Package as an .aar
Add RecurrencePicker (from AOSP calendar app)
Add TimeZonePicker (from AOSP calendar app)
Resolve bold typeface errors on KitKat
Add dismiss listener for RadialTimePicker
Add option to set "Done" text for RadialTimePicker
Add Italian translations

1.4.2

Fix the ordering of months in the DatePicker
Add header to DatePicker keyboards for better UX

1.4.1

Fix pom.xml file in Maven Central due to an improper Gradle commit of 1.4.0 (Gradle is still a work-in-progress)

1.4.0

Addition of ExpirationPicker for e.g. credit card expiration date
Addition of CalendarPicker from AOSP (see stock Calendar app) [screenshot here]
Addition of RadialTimePicker from AOSP (see stock Calendar app) [screenshot here]
Improved localization of months in DatePicker
Removed dependency on ViewPagerIndicator
Fix for Android 4.3 font rendering
Fix for year field of DatePicker when using e.g. year/month/day format

1.3.1

Improve UX for min/max for NumberPicker
Added ListView demos to the sample app

1.3.0

Add Catalan, Spanish
Enable min/max for NumberPicker
Added Javadoc comments
Added universal handlers
Added picker references
UX tweak for DatePicker indicator

1.2.0

Removed some unused fonts from sample/ project
Refactor to Builder pattern
Fix for Gingerbread font in DatePicker
Added optional label text to NumberPicker
DatePicker reorders text and keyboards based on locale
NumberPicker scrolls horizontally to allow for more numbers

1.1.0

Added HMS (hours:minutes:seconds) PickerFragment
Allow for PickerFragments within target fragments
Allow for February 29th input

Including in Your Project

Android-BetterPickers is presented as an Android library project. A standalone JAR is not possible due to the theming capabilities offered by the DialogFragments.

You can include this project by referencing it as a library project in Eclipse or ant. Note that to use this library, both it and your project must be compiled with Android 4.0 (API level 14) or newer, similar to ActionBarSherlock.

If you are a Maven user you can easily include the library by specifying it as a dependency:

<dependency>
  <groupId>com.doomonafireball.betterpickers</groupId>
  <artifactId>library</artifactId>
  <version>1.5.3</version>
  <type>aar</type>
</dependency>

If you are a Gradle user you can also easily include the library:

compile 'com.doomonafireball.betterpickers:library:1.5.3'

If you are bringing in the support library you may need to add an exclusion:

compile ("com.doomonafireball.betterpickers:library:1.5.3") {
    exclude group: 'com.android.support', module: 'support-v4'
}

There is a standalone Gradle demo here that may also help.

Usage

For a working implementation of this project see the sample/ folder.

Implement the appropriate Handler callbacks:

public class MyActivity extends Activity implements 
  DatePickerDialogFragment.DatePickerDialogHandler {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    // ...
  }
  
  @Override
  public void onDialogDateSet(int year, int monthOfYear, int dayOfMonth) {
    // Do something with your date!
  }
}

Use one of the Builder classes to create a PickerDialog with a theme:

DatePickerBuilder dpb = new DatePickerBuilder()
    .setFragmentManager(getSupportFragmentManager())
    .setStyleResId(R.style.BetterPickersDialogFragment);
dpb.show();

Theming

For a demonstration of theming, see the sample/ folder.

You can use your own themes if you'd like to change certain attributes. BetterPickers currently allows for customization of the following attributes:

    bpDialogBackground       :: the drawable (preferably a 9-patch) used as a window background for the DialogFragment
    bpTextColor              :: the color (optionally state list) for all text in the DialogFragment
    bpDeleteIcon             :: the drawable (optionally state list) for the delete button
    bpCheckIcon              :: the drawable (optionally state list) for the check button in the DateDialogPicker
    bpKeyBackground          :: the drawable (optionally state list) for the keyboard buttons
    bpButtonBackground       :: the drawable (optionally state list) for the Set, Cancel, and Delete buttons
    bpDividerColor           :: the color used for the DialogFragment dividers
    bpKeyboardIndicatorColor :: the color used for the ViewPagerIndicator on the DateDialogPicker

Create your own custom theme in styles.xml:

<style name="MyCustomBetterPickerTheme">
    <item name="bpDialogBackground">@drawable/custom_dialog_background</item>
    <item name="bpTextColor">@color/custom_text_color</item>
    <item name="bpDeleteIcon">@drawable/ic_backspace_custom</item>
    <item name="bpCheckIcon">@drawable/ic_check_custom</item>
    <item name="bpKeyBackground">@drawable/key_background_custom</item>
    <item name="bpButtonBackground">@drawable/button_background_custom</item>
    <item name="bpDividerColor">@color/custom_divider_color</item>
    <item name="bpKeyboardIndicatorColor">@color/custom_keyboard_indicator_color</item>
</style>

Instantiate your DialogFragment using your custom theme:

DatePickerBuilder dpb = new DatePickerBuilder()
    .setFragmentManager(getSupportFragmentManager())
    .setStyleResId(R.style.MyCustomBetterPickerTheme);
dpb.show();

Contribution

Pull requests are welcome!

Feel free to contribute to BetterPickers.

If you've fixed a bug or have a feature you've added, just create a pull request.

If you've found a bug, want a new feature, or have other questions, file an issue. I'll try to answer as soon as I find the time.

Credits

Thanks to JakeWharton for his work on ViewPagerIndicator.

Thanks to OAK and WillowTree Apps for Maven assistance and possible future improvements.

License

Copyright 2013 Derek Brameyer

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.

alcntml/android-betterpickers