Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rspective/pagerdatepicker
PagerDatePicker for Android
https://github.com/rspective/pagerdatepicker
android datepicker ui
Last synced: about 2 months ago
JSON representation
PagerDatePicker for Android
- Host: GitHub
- URL: https://github.com/rspective/pagerdatepicker
- Owner: rspective
- License: apache-2.0
- Created: 2015-03-18T17:27:08.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2017-04-17T09:02:52.000Z (over 7 years ago)
- Last Synced: 2024-03-27T03:14:08.058Z (9 months ago)
- Topics: android, datepicker, ui
- Language: Java
- Size: 1.2 MB
- Stars: 80
- Watchers: 26
- Forks: 29
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PagerDatePicker
### Version: 1.2.0
[](https://www.apache.org/licenses/LICENSE-2.0) [](http://android-arsenal.com/details/1/1710)
### Description
PagerDatePicker is a library for Android which allows to setup horizontal (for now;)) date list picker. It is a combination of few main Android components:
* android.support.v7.widget.RecyclerView
* android.support.v4.view.ViewPager
* android.support.v4.app.FragmentStatePagerAdapter
* android.support.v7.widget.RecyclerView.Adapter
Notice that PagerDatePicker is a project under development.
#### Welcome to fork and pull request.
### Features
#### XML attributes:
Support date format MM-dd-yyyy
```xml
```
#### API
* Animations
You can assign animation for selected day. This could be set for whole date item view or just for single one. To achieve this you have to load and assign animation to the adapter:
```java
dateAdapter.setCurrentViewAnimation(AnimationUtils.loadAnimation(CONTEXT, ANIM_ID_FOR_YOUR_ANIMATION));
```
To select which view has to be animated you have to override below method in your ViewHolder
```java
protected abstract View getCurrentViewToAnimate();
```
#### Deafult and custom date adapter
If default date item is not enough for you don't worry, you can create your own custom date adapter where you can apply default style/view/functions to your date item.
##### Things to know:
- You have to create your custom adapter which has to extend AbsDateAdapter
- Your view holder has to extend AbsDateItemHolder
- Implement required methods and add your own if you need
To check details, please see demo app.
### Screenshot
### Quick Setup（Basic Usage)
##### 1.Integration
###### Gradle
```xml
dependencies {
compile 'pl.rspective.pagerdatepicker:pagerdatepicker:1.2.0'
}
```
##### 2.Usage (for default date adapter)
Please note, that supported date format is MM-dd-yyyy
###### 1. Add picker and pager to your view
```xml
```
###### 2. Add item decoration for your picker (OPTIONAL)
You can do this in two ways:
```java
dateList.addItemDecoration(new RecyclerViewInsetDecoration(this);
```
Default insets is 1dp
```java
dateList.addItemDecoration(new RecyclerViewInsetDecoration(this, R.dimen.date_card_insets));
```
Add your own insets value
###### 3. Create deafult adapter with date range and assign it to our picker
```java
dateList.setAdapter(new DefaultDateAdapter(start, end));
```
###### 4. Init pager adapter and assign it to our datepicker
```java
DatePagerFragmentAdapter fragmentAdapter = new DatePagerFragmentAdapter(getSupportFragmentManager(), dateList.getDateAdapter()) {
@Override
protected Fragment getFragment(int position, long date) {
return ...
}
};
pager.setAdapter(fragmentAdapter);
dateList.setPager(pager);
```
###### 5. We are almost there. Now you have to assign a listener to your picker
```java
dateList.setDatePickerListener(new DateRecyclerView.DatePickerListener() {
@Override
public void onDatePickerItemClick(DateItem dateItem, int position) {
//User clicked date item from top date picker
}
@Override
public void onDatePickerPageSelected(int position) {
//User changed date using swipe (left/right)
}
@Override
public void onDatePickerPageStateChanged(int state) {
//User changed page
}
@Override
public void onDatePickerPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
//User changed page
}
});
```
If you want to change the default color, just override below colors in your colors.xml:
```xml
#ff5c5c5c
#ffff353b
#ff373737
#ffd5d5d5
#ff9a9a9a
#FFFFFFFF
```
#### If you want to see more details, go ahead and check the demo!
### Assets
Demo launcher icon was made by [jerrylow](https://www.iconfinder.com/jerrylow)
License
--------
Copyright 2015 RSPECTIVE P RYCHLIK SPÓŁKA JAWNA
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.