GitHub - MagicMashRoom/SuperCalendar: @Deprecated android 自定义日历控件 支持左右无限滑动 周月切换 标记日期显示 自定义显示效果跳转到指定日期
- 看到本篇文章的同学估计也是实验课或者项目需求中需要一个日历表,当我接到这个需求的时候,当时脑子压根连想都没想,这么通用的控件,GitHub上一搜一大堆不是嘛。可是等到真正做起来的时候,扎心了老铁,GitHub上的大神居然异常的不给力,都是实现了基本功能,能够滑动切换月份,找实现了周月切换功能的开源库很难。终于我费尽千辛万苦找到一个能够完美切换的项目时,你周月切换之后的数据乱的一塌糊涂啊!!!
- 算了,自己撸一个!!!
项目链接 SuperCalendar
- 如果你感觉到对你有帮助,欢迎star
- 如果你感觉对代码有疑惑,或者需要修改的地方,欢迎issue
主要特性
- 日历样式完全自定义,拓展性强
- 左右滑动切换上下周月,上下滑动切换周月模式
- 抽屉式周月切换效果
- 标记指定日期(marker)
- 跳转到指定日期
思路
使用方法
XML布局
- 新建XML布局
RecyclerView的layout_behavior为com.ldf.calendar.behavior.RecyclerViewBehavior
<android.support.design.widget.CoordinatorLayout android:id="@+id/content" android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_weight="1"> <com.ldf.calendar.view.MonthPager android:id="@+id/calendar_view" android:layout_width="match_parent" android:layout_height="300dp" android:background="#fff"> </com.ldf.calendar.view.MonthPager> <android.support.v7.widget.RecyclerView android:id="@+id/list" android:layout_width="match_parent" android:layout_height="wrap_content" app:layout_behavior="com.ldf.calendar.behavior.RecyclerViewBehavior" android:background="#c2c2c2" android:layout_gravity="bottom"/> </android.support.design.widget.CoordinatorLayout>
自定义日历样式
- 新建CustomDayView继承自DayView并重写refreshContent 和 copy 两个方法
@Override public void refreshContent() { //你的代码 你可以在这里定义你的显示规则 super.refreshContent(); } @Override public IDayRenderer copy() { return new CustomDayView(context , layoutResource); }
- 新建CustomDayView实例,并作为参数构建CalendarViewAdapter
CustomDayView customDayView = new CustomDayView(context, R.layout.custom_day); calendarAdapter = new CalendarViewAdapter( context, onSelectDateListener, CalendarAttr.CalendarType.MONTH, CalendarAttr.WeekArrayType.Monday, customDayView);
初始化View
- 目前来看 相比于Dialog选择日历 我的控件更适合于Activity/Fragment在Activity的
onCreate或者Fragment的onCreateView你需要实现这两个方法来启动日历并装填进数据
@Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_syllabus); initCalendarView(); } private void initCalendarView() { initListener(); CustomDayView customDayView = new CustomDayView(context, R.layout.custom_day); calendarAdapter = new CalendarViewAdapter( context, onSelectDateListener, CalendarAttr.CalendarType.MONTH, CalendarAttr.WeekArrayType.Monday, customDayView); initMarkData(); initMonthPager(); }
使用此方法回调日历点击事件
private void initListener() { onSelectDateListener = new OnSelectDateListener() { @Override public void onSelectDate(CalendarDate date) { //your code } @Override public void onSelectOtherMonth(int offset) { //偏移量 -1表示上一个月 , 1表示下一个月 monthPager.selectOtherMonth(offset); } }; }
使用此方法初始化日历标记数据
private void initMarkData() { HashMap markData = new HashMap<>(); //1表示红点,0表示灰点 markData.put("2017-8-9" , "1"); markData.put("2017-7-9" , "0"); markData.put("2017-6-9" , "1"); markData.put("2017-6-10" , "0"); calendarAdapter.setMarkData(markData); }
使用此方法给MonthPager添加上相关监听
monthPager.addOnPageChangeListener(new MonthPager.OnPageChangeListener() { @Override public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) { } @Override public void onPageSelected(int position) { mCurrentPage = position; currentCalendars = calendarAdapter.getAllItems(); if(currentCalendars.get(position % currentCalendars.size()) instanceof Calendar){ //you code } } @Override public void onPageScrollStateChanged(int state) { } });
重写onWindowFocusChanged方法,使用此方法得知calendar和day的尺寸
@Override public void onWindowFocusChanged(boolean hasFocus) { super.onWindowFocusChanged(hasFocus); if(hasFocus && !initiated) { CalendarDate today = new CalendarDate(); calendarAdapter.notifyDataChanged(today); initiated = true; } }
- 大功告成,如果还不清晰,请下载DEMO
Download
Gradle: Step 1. Add it in your root build.gradle at the end of repositories:
allprojects {
repositories {
...
maven { url 'https://www.jitpack.io' }
}
}Step 2. Add the dependency
dependencies {
compile 'com.github.MagicMashRoom:SuperCalendar:1.6'
}
Licence
Copyright 2017 MagicMashRoom, Inc.