這是個日期顯示
和選擇
庫,可以用來選擇一段連續
的和多個不連續
的日期,具體的UI完全抽象出來了,可以高度自定義(GITHUB地址)
支持的功能:
- 選擇一段
連續
的和多個不連續
的日期 - 提供了兩個工具類(SingleMonthSelector、CalendarSelector)用來處理單個月和多個連續月日期的選擇
- 可以攔截選擇事件,當選擇的日期長度有限制或某些特殊的日期不可以選擇時,在這里做處理會很方便
- 提供的SingleMonthSelector、CalendarSelector兩個工具類都支持狀態保持,可以restore之前的狀態
- UI顯示可以非常靈活的進行自定義,可以為每個月中的天指定不同的layout,還可以為每月的行和列指定不同的layout
- 因為現在世界上每個禮拜的第一天并不完全一致,已知使用比較多的有(
SUNDAY
、SATURDAY
、MONDAY
)這三種,都提供了支持 - 為了在layout的時候能實時的查看具體的顯示樣式,所以提供了
edit mode
支持,在開發調試的時候還是比較方便的 - 支持API+8以上版本
預覽
如何使用
在Gradle文件中加入依賴
compile 'com.tubb.calendarselector.library:calendar-selector:0.1.3'
使用MonthView來顯示月,這個是我們的自定義View,主要工作是組合顯示某個月的天數
<com.tubb.calendarselector.library.MonthView
android:id="@+id/ssMv"
android:layout_width="match_parent"
android:layout_height="300dp"
sc:sc_firstday_week="sunday"
sc:sc_draw_monthday_only="false"
sc:sc_month="2016-3"/>
為了方便,我們提供兩個工具類來進行日期的選擇功能,SingleMonthSelector用來進行單個月的選擇,CalendarSelector用來進行多個連續月的選擇,
我們也為這兩個工具類提供了狀態保持的功能,為了在必要的時候進行狀態的恢復,給用戶更好一點的體驗,具體使用可以查看StateSavedActivity
singleMonthSelector.bind(monthView);
使用CalendarSelector (這里有點要注意的是:還不支持ListView
,針對這種情況直接使用RecyclerView
好了)
calendarSelector.bind(containerViewGroup, monthView, itemPosition);
我們為這兩個日期選擇工具類都提供了兩種模式來支持選擇連續(SEGMENT)
和不連續(INTERVAL)
的一段時間
SEGMENT
MODE
selector = new CalendarSelector(data, CalendarSelector.Mode.SEGMENT);
selector.setSegmentSelectListener(new SegmentSelectListener() {
@Override
public void onSegmentSelect(FullDay startDay, FullDay endDay) {
Log.d(TAG, "segment select " + startDay.toString() + " : " + endDay.toString());
}
@Override
public boolean onInterceptSelect(FullDay selectingDay) { // one day intercept
if(SCDateUtils.isToday(selectingDay.getYear(), selectingDay.getMonth(), selectingDay.getDay())){
Toast.makeText(CalendarSelectorActivity.this, "Today can't be selected", Toast.LENGTH_SHORT).show();
return true;
}
return super.onInterceptSelect(selectingDay);
}
@Override
public boolean onInterceptSelect(FullDay startDay, FullDay endDay) { // segment days intercept
int differDays = SCDateUtils.countDays(startDay.getYear(), startDay.getMonth(), startDay.getDay(),
endDay.getYear(), endDay.getMonth(), endDay.getDay());
Log.d(TAG, "differDays " + differDays);
if(differDays > 10) {
Toast.makeText(CalendarSelectorActivity.this, "Selected days can't more than 10", Toast.LENGTH_SHORT).show();
return true;
}
return super.onInterceptSelect(startDay, endDay);
}
@Override
public void selectedSameDay(FullDay sameDay) { // selected the same day
super.selectedSameDay(sameDay);
}
});
INTERVAL
mode
selector = new SingleMonthSelector(CalendarSelector.Mode.INTERVAL);
selector.setIntervalSelectListener(new IntervalSelectListener() {
@Override
public void onIntervalSelect(List<FullDay> selectedDays) {
Log.d(TAG, "interval selected days " + selectedDays.toString());
}
@Override
public boolean onInterceptSelect(List<FullDay> selectedDays, FullDay selectingDay) {
if(selectedDays.size() >= 5) {
Toast.makeText(SingleMonthSelectorActivity.this, "Selected days can't more than 5", Toast.LENGTH_LONG).show();
return true;
}
return super.onInterceptSelect(selectedDays, selectingDay);
}
});
在這兩種模式下我們都提供了選擇
事件的攔截功能,這樣就有能力來實現一些限制,比如日期長度的限制、某些特殊日期不可選擇等
具體如何使用可以查看示例程序 SingleMonthSelectorActivity 和 CalendarSelectorActivity
如何自定義
我們為MonthView的顯示提供了非常靈活的自定義功能,MonthView本身就是一個功能完善的自定義View,并且具體某天的顯示都可以在layout文件中配置
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
xmlns:tools="http://schemas.android.com/tools">
<TextView
android:id="@+id/tvDay"
android:layout_width="30dp"
android:layout_height="30dp"
android:textSize="@dimen/t_16"
tools:text="0"
android:layout_gravity="center"
android:gravity="center"
android:textColor="@color/color_dayview_text_selector"
android:background="@drawable/drawable_custom_dayview_text_bg"
/>
</FrameLayout>
為了比較靈活的實現上面的自定義功能,我們特意抽象出來一個接口DayViewInflater
,只要實現這個接口,并進行相應的設置(MonthView.setSCMonth(scMonth, new CustomDayViewInflater(context))
)就行
public class CustomDayViewInflater extends DayViewInflater{
public CustomDayViewInflater(Context context) {
super(context);
}
@Override
public DayViewHolder inflateDayView(ViewGroup container) {
View dayView = mLayoutInflater.inflate(R.layout.layout_dayview_custom, container, false);
return new CustomDayViewHolder(dayView);
}
public static class CustomDayViewHolder extends DayViewHolder{
protected TextView tvDay;
private int mPrevMonthDayTextColor;
private int mNextMonthDayTextColor;
public CustomDayViewHolder(View dayView) {
super(dayView);
tvDay = (TextView) dayView.findViewById(com.tubb.calendarselector.library.R.id.tvDay);
mPrevMonthDayTextColor = ContextCompat.getColor(mContext, com.tubb.calendarselector.library.R.color.c_999999);
mNextMonthDayTextColor = ContextCompat.getColor(mContext, com.tubb.calendarselector.library.R.color.c_999999);
}
@Override
public void setCurrentMonthDayText(FullDay day, boolean isSelected) {
tvDay.setText(String.valueOf(day.getDay()));
tvDay.setSelected(isSelected);
}
@Override
public void setPrevMonthDayText(FullDay day) {
tvDay.setTextColor(mPrevMonthDayTextColor);
tvDay.setText(String.valueOf(day.getDay()));
}
@Override
public void setNextMonthDayText(FullDay day) {
tvDay.setTextColor(mNextMonthDayTextColor);
tvDay.setText(String.valueOf(day.getDay()));
}
}
}
既然是日期的選擇,那么會有兩種狀態(選中
、未選中
)之間的切換,我們也把這個狀態切換的接口暴露出來了(DayViewHolder.setCurrentMonthDayText(FullDay day, boolean isSelected)
),
這樣我們就可以在狀態切換的時候弄些動畫什么的,具體的可以查看AnimDayViewInflater示例程序
@Override
public void setCurrentMonthDayText(FullDay day, boolean isSelected) {
boolean oldSelected = tvDay.isSelected();
tvDay.setText(String.valueOf(day.getDay()));
tvDay.setSelected(isSelected);
// view selected animation
if(!oldSelected && isSelected){
AnimatorSet animatorSet = new AnimatorSet();
animatorSet.setInterpolator(AnimationUtils.loadInterpolator(mContext, android.R.anim.bounce_interpolator));
animatorSet.play(ObjectAnimator.ofFloat(tvDay, "scaleX", 0.5f, 1.0f))
.with(ObjectAnimator.ofFloat(tvDay, "scaleY", 0.5f, 1.0f));
animatorSet.setDuration(500)
.start();
}
}
在有些情況下可能會為MonthView的行和列加一些裝飾顯得更美觀一點,這個功能我們也是支持的,具體如何實現可以查看 DecorDayViewInflater示例程序
@Override
public Decor inflateHorizontalDecor(ViewGroup container, int row, int totalRow) {
return new Decor(mLayoutInflater.inflate(R.layout.view_horizontal_decor, container, false), true);
}
@Override
public Decor inflateVerticalDecor(ViewGroup container, int col, int totalCol) {
return new Decor(mLayoutInflater.inflate(R.layout.view_vertical_decor, container, false), true);
}
我們還為 MonthView提供了一些自定的屬性,比如只顯示本月的日期
、指定一個星期的哪天為第一天
,還有一些為開發調試時候方便而加入的屬性等
<resources>
<declare-styleable name="MonthView">
<!-- only draw the month day, or not, default is false -->
<attr name="sc_draw_monthday_only" format="boolean"/>
<!-- start day of a week, we support (sunday、monday and saturday) -->
<attr name="sc_firstday_week" format="enum">
<enum name="sunday" value="1"/>
<enum name="monday" value="2"/>
<enum name="saturday" value="7"/>
</attr>
<!-- editor mode only -->
<!-- test selected days (format:1,2,3,4) -->
<attr name="sc_selected_days" format="string"/>
<!-- test month (format:2016-3) -->
<attr name="sc_month" format="string"/>
</declare-styleable>
</resources>
優化建議
如果使用過程中有任何的疑問都可以直接聯系我(Email:tu.bingbing@163.com
)或者在GITHUB
提issue,自己也會一直優化和維護這個項目:)