Skip to content

A material-styled android view that provisions picking of a date, time & recurrence option, all from a single user-interface.

License

Notifications You must be signed in to change notification settings

chrisonline/SublimePicker

 
 

Repository files navigation

SublimePicker

A customizable view that provisions picking of a date, time & recurrence option, all from a single user-interface. You can also view 'SublimePicker' as a collection of material-styled (API 23) DatePicker, TimePicker & RecurrencePicker, backported to API 14.

With the release of version 2, SublimePicker now allows date-range selection.

All three components have been converted to views, which enables us to add/embed them anywhere - add them to a 'Dialog', a 'PopupWindow', or use them as any regular android widget.

Almost all styling possibilities have been exposed through attrs. If something has been missed, please bring it to my attention.

SublimePicker provides a single point of entry to all three pickers. What I mean is that once SublimePicker is available for interaction, the user can select a date, a time & a recurrence option without leaving the picker.

Gradle dependency

implement 'com.colapps.sublimepickerlibrary:sublimepickerlibrary:2.1.8'

ProGuard rule

Not needed anymore is added in the library

Walkthrough

Following screenshots have been taken from the sample application: Get it on Google Play

Version 2 allows date-range selection using SublimeOptions#setCanPickDateRange(boolean). Picking date range is one fluent gesture which begins with a long-press on the intended start-date, followed by a drag onto the intended end-date. The range can span as many days, months or years, as needed. During a drag, approaching the left/right edge of date picker scrolls the previous/next month into view.

Date Picker Date Range Selection Date Range Multiple Months
Launching into **DatePicker** Monitor Date range selection spanning multiple months
Launching into DatePicker Date Range Selection Mode Date Range Selection Months

Button at bottom-left corner can be used to switch to TimePicker:

Time Picker Recurrence Picker
Swtich to TimePicker The overflow button at top-right opens the RecurrencePicker
The overflow button at top-right opens the RecurrencePicker Quick Selection or Custom
RecurrencePicker Custom View Until Date - DatePicker
The overflow button at top-right opens the RecurrencePicker Choosing Custom... from this menu brings you to **RecurrenceOptionCreator Choosing Custom... from this menu brings you to **RecurrenceOptionCreator
Quick Recurrence Options and Custom Options including Forever, Count and Until Date Until a date shows a stripped down version of DatePicker
Sample Application Results single date Results date range
Sample Application Results of the selection in sample application (single date) Results of the selection in sample application (date range)
View of the sample application Results of the selection in sample application (single date) Results of the selection in sample application (date range)

How-tos will be added in a day or two...

License

Copyright (c) 2018 Vikram Kakkar

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.

About

A material-styled android view that provisions picking of a date, time & recurrence option, all from a single user-interface.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 100.0%