可能是第十好的Android 开源 日历 Calendar 仿小米
来源:互联网 发布:it维修服务公司 编辑:程序博客网 时间:2024/06/05 05:59
SuperCalendar
简介
- 博主现在工作在一家教育公司,最近公司的产品狗扔过来一个需求,说要做一个可以周月切换的课表,可以展示用户在某一天的上课安排。接到这个任务之后我研究了很多的日历控件,并且抽出了一个calenderlib。先看一下最后的项目中的效果:
- 看到本篇文章的同学估计也是实验课或者项目需求中需要一个日历表,当我接到这个需求的时候,当时脑子压根连想都没想,这么通用的控件,GitHub上一搜一大堆不是嘛。可是等到真正做起来的时候,扎心了老铁,GitHub上的大神居然异常的不给力,都是实现了基本功能,能够滑动切换月份,找实现了周月切换功能的开源库很难。终于我费尽千辛万苦找到一个能够完美切换的项目时,你周月切换之后的数据乱的一塌糊涂啊!!!
- 算了,自己撸一个!!!
项目链接 SuperCalendar
- 如果你感觉到对你有帮助,欢迎star
- 如果你感觉对代码有疑惑,或者需要修改的地方,欢迎issue
主要特性
- 日历样式完全自定义,拓展性强
- 左右滑动切换上下周月,上下滑动切换周月模式
- 抽屉式周月切换效果
- 标记指定日期(marker)
- 跳转到指定日期
思路
- Calendar的绘制由CalendarRenderer完成,IDayRenderer实现自定义的日期效果,CalendarAttr中存储日历的属性。
- 首先看一下Calendar的代码,Calendar主要是初始化Renderer和Attr,然后接受View的生命周期
- 在OnDraw的时候调用Renderer的onDraw方法,在点击事件onTouchEvent触发时,调用Renderer的点击处理逻辑
private void initAttrAndRenderer() { calendarAttr = new CalendarAttr(); calendarAttr.setWeekArrayType(CalendarAttr.WeekArrayType.Monday); calendarAttr.setCalendarType(CalendarAttr.CalendayType.MONTH); renderer = new CalendarRenderer(this , calendarAttr , context); renderer.setOnSelectDateListener(onSelectDateListener); } @Override protected void onDraw(Canvas canvas) { super.onDraw(canvas); renderer.draw(canvas); } private float posX = 0; private float posY = 0; /* * 触摸事件为了确定点击的位置日期 */ @Override public boolean onTouchEvent(MotionEvent event) { switch (event.getAction()) { case MotionEvent.ACTION_DOWN: posX = event.getX(); posY = event.getY(); break; case MotionEvent.ACTION_UP: float disX = event.getX() - posX; float disY = event.getY() - posY; if (Math.abs(disX) < touchSlop && Math.abs(disY) < touchSlop) { int col = (int) (posX / cellWidth); int row = (int) (posY / cellHeight); onAdapterSelectListener.cancelSelectState(); renderer.onClickDate(col, row); onAdapterSelectListener.updateSelectState(); invalidate(); } break; } return true; }
- 然后看一下CalendarRenderer的代码,Renderer承担了Calendar的绘制任务,首先renderer根据种子日期seedDate填充出Calendar包含的Date数据,calendar中持有一个6*7二维数组来存放日期数据。然后在onDraw的时候通过IDayRenderer来完成对日历的绘制。当点击日期改变了日期的状态时,首先改变对应日期的状态State,然后重绘Calendar。
private void instantiateMonth() { int lastMonthDays = Utils.getMonthDays(seedDate.year, seedDate.month - 1); // 上个月的天数 int currentMonthDays = Utils.getMonthDays(seedDate.year, seedDate.month); // 当前月的天数 int firstDayPosition = Utils.getFirstDayWeekPosition(seedDate.year, seedDate.month , CalendarViewAdapter.weekArrayType); int day = 0; for (int row = 0; row < Const.TOTAL_ROW; row++) { day = fillWeek(lastMonthDays, currentMonthDays, firstDayPosition, day, row); } } private int fillWeek(int lastMonthDays, int currentMonthDays, int firstDayWeek, int day, int row) { for (int col = 0; col < Const.TOTAL_COL; col++) { int position = col + row * Const.TOTAL_COL; // 单元格位置 if (position >= firstDayWeek && position < firstDayWeek + currentMonthDays) { // 本月的 day ++; fillCurrentMonthDate(day, row, col); } else if (position < firstDayWeek) { //last month instantiateLastMonth(lastMonthDays, firstDayWeek, row, col, position); } else if (position >= firstDayWeek + currentMonthDays) {//next month instantiateNextMonth(currentMonthDays, firstDayWeek, row, col, position); } } return day; } public void draw(Canvas canvas) { for (int row = 0; row < Const.TOTAL_ROW; row++) { if (weeks[row] != null) { for (int col = 0; col < Const.TOTAL_COL; col ++) { if (weeks[row].days[col] != null) { dayRenderer.drawDay(canvas , weeks[row].days[col]); } } } } } public void onClickDate(int col, int row) { if (col >= Const.TOTAL_COL || row >= Const.TOTAL_ROW) return; if (weeks[row] != null) { if(attr.getCalendarType() == CalendarAttr.CalendayType.MONTH) { if(weeks[row].days[col].getState() == State.CURRENT_MONTH){ weeks[row].days[col].setState(State.SELECT); selectedDate = weeks[row].days[col].getDate(); CalendarViewAdapter.saveDate(selectedDate); onSelectDateListener.onSelectDate(selectedDate); seedDate = selectedDate; } else if (weeks[row].days[col].getState() == State.PAST_MONTH){ selectedDate = weeks[row].days[col].getDate(); CalendarViewAdapter.saveDate(selectedDate); onSelectDateListener.onSelectOtherMonth(-1); onSelectDateListener.onSelectDate(selectedDate); } else if (weeks[row].days[col].getState() == State.NEXT_MONTH){ selectedDate = weeks[row].days[col].getDate(); CalendarViewAdapter.saveDate(selectedDate); onSelectDateListener.onSelectOtherMonth(1); onSelectDateListener.onSelectDate(selectedDate); } } else { weeks[row].days[col].setState(State.SELECT); selectedDate = weeks[row].days[col].getDate(); CalendarViewAdapter.saveDate(selectedDate); onSelectDateListener.onSelectDate(selectedDate); seedDate = selectedDate; } } }
- 调用Renderer的draw方法时使用dayRenderer.drawDay(canvas , weeks[row].days[col]),dayRenderer是一个接口,在lib中有一个DayView 的抽象类实现该接口。 其中的drawDay方法完成了对该天到calendar的canvas上的绘制
@Override public void drawDay(Canvas canvas , Day day) { this.day = day; refreshContent(); int saveId = canvas.save(); canvas.translate(day.getPosCol() * getMeasuredWidth(), day.getPosRow() * getMeasuredHeight()); draw(canvas); canvas.restoreToCount(saveId); }
- 使用继承自ViewPager的MonthPager来存放calendar的view
viewPageChangeListener = new ViewPager.OnPageChangeListener() {} //新建viewPagerChangeListener @Override protected void onSizeChanged(int w, int h, int oldW, int oldH) { cellHeight = h / 6; super.onSizeChanged(w, h, oldW, oldH); }//重写onSizeChanged,获取dayView的高度 public int getTopMovableDistance() { CalendarViewAdapter calendarViewAdapter = (CalendarViewAdapter) getAdapter(); rowIndex = calendarViewAdapter.getPagers().get(currentPosition % 3).getSelectedRowIndex(); return cellHeight * rowIndex; }//计算周月切换时在到达选中行之前MonthPager收起的距离 public int getRowIndex() { CalendarViewAdapter calendarViewAdapter = (CalendarViewAdapter) getAdapter(); rowIndex = calendarViewAdapter.getPagers().get(currentPosition % 3).getSelectedRowIndex(); Log.e("ldf","getRowIndex = " + rowIndex); return rowIndex; }//计算选中日期所在的行数
- 使用CalendarViewAdapter为MonthPager填充calendar的实例
@Override public void setPrimaryItem(ViewGroup container, int position, Object object) { super.setPrimaryItem(container, position, object); this.currentPosition = position; } @Override public Object instantiateItem(ViewGroup container, int position) { if(position < 2){ return null; } Calendar calendar = calendars.get(position % calendars.size()); if(calendarType == CalendarAttr.CalendayType.MONTH) { CalendarDate current = seedDate.modifyMonth(position - MonthPager.CURRENT_DAY_INDEX); current.setDay(1);//每月的种子日期都是1号 calendar.showDate(current); } else { CalendarDate current = seedDate.modifyWeek(position - MonthPager.CURRENT_DAY_INDEX); if(weekArrayType == 1) { calendar.showDate(Utils.getSaturday(current)); } else { calendar.showDate(Utils.getSunday(current)); }//每周的种子日期为这一周的最后一天 calendar.updateWeek(rowCount); } if (container.getChildCount() == calendars.size()) { container.removeView(calendars.get(position % 3)); } if(container.getChildCount() < calendars.size()) { container.addView(calendar, 0); } else { container.addView(calendar, position % 3); } return calendar; }
- 日历在切换周月时切换日历中填充的数据
- 在月模式切换成周模式时,将当前页的seedDate拿出来刷新本页数据,并且更新指定行数的周数据,然后得到seedDate下一周的周日作为下一页的seedDate,刷新下一页的数据,并且更新指定行数的周数据。上一页同理
- 也是说假设我当前选择的是6月12号周日,处于日历的第二行,也是说下一页的seedDate是6月19号,然后刷新6月19号所在周的数据到选定的第二行。
当切换周月时,把三页的数据都会重新刷新一遍,以保证数据的正确性。
public void switchToMonth() { if(calendars != null && calendars.size() > 0 && calendarType != CalendarAttr.CalendayType.MONTH){ calendarType = CalendarAttr.CalendayType.MONTH; MonthPager.CURRENT_DAY_INDEX = currentPosition; Calendar v = calendars.get(currentPosition % 3);//0 seedDate = v.getSeedDate(); Calendar v1 = calendars.get(currentPosition % 3);//0 v1.switchCalendarType(CalendarAttr.CalendayType.MONTH); v1.showDate(seedDate); Calendar v2 = calendars.get((currentPosition - 1) % 3);//2 v2.switchCalendarType(CalendarAttr.CalendayType.MONTH); CalendarDate last = seedDate.modifyMonth(-1); last.setDay(1); v2.showDate(last); Calendar v3 = calendars.get((currentPosition + 1) % 3);//1 v3.switchCalendarType(CalendarAttr.CalendayType.MONTH); CalendarDate next = seedDate.modifyMonth(1); next.setDay(1); v3.showDate(next); } } public void switchToWeek(int rowIndex) { rowCount = rowIndex; if(calendars != null && calendars.size() > 0 && calendarType != CalendarAttr.CalendayType.WEEK){ calendarType = CalendarAttr.CalendayType.WEEK; MonthPager.CURRENT_DAY_INDEX = currentPosition; Calendar v = calendars.get(currentPosition % 3); seedDate = v.getSeedDate(); rowCount = v.getSelectedRowIndex(); Calendar v1 = calendars.get(currentPosition % 3); v1.switchCalendarType(CalendarAttr.CalendayType.WEEK); v1.showDate(seedDate); v1.updateWeek(rowIndex); Calendar v2 = calendars.get((currentPosition - 1) % 3); v2.switchCalendarType(CalendarAttr.CalendayType.WEEK); CalendarDate last = seedDate.modifyWeek(-1); if(weekArrayType == 1) { v2.showDate(Utils.getSaturday(last)); } else { v2.showDate(Utils.getSunday(last)); }//每周的种子日期为这一周的最后一天 v2.updateWeek(rowIndex); Calendar v3 = calendars.get((currentPosition + 1) % 3); v3.switchCalendarType(CalendarAttr.CalendayType.WEEK); CalendarDate next = seedDate.modifyWeek(1); if(weekArrayType == 1) { v3.showDate(Utils.getSaturday(next)); } else { v3.showDate(Utils.getSunday(next)); }//每周的种子日期为这一周的最后一天 v3.updateWeek(rowIndex); } }
- 使用CoordinateLayout的特性来做周月模式切换
1.RecyclerViewBehavior
@Override public boolean onStartNestedScroll(CoordinatorLayout coordinatorLayout, RecyclerView child, View directTargetChild, View target, int nestedScrollAxes) { LinearLayoutManager linearLayoutManager = (LinearLayoutManager) child.getLayoutManager(); if(linearLayoutManager.findFirstCompletelyVisibleItemPosition() > 0) { return false; } boolean isVertical = (nestedScrollAxes & ViewCompat.SCROLL_AXIS_VERTICAL) != 0; int firstRowVerticalPosition = (child == null || child.getChildCount() == 0) ? 0 : child.getChildAt(0).getTop(); boolean recycleviewTopStatus = firstRowVerticalPosition >= 0; return isVertical && (recycleviewTopStatus || !Utils.isScrollToBottom()) && child == directTargetChild; } @Override public void onNestedPreScroll(CoordinatorLayout coordinatorLayout, RecyclerView child, View target, int dx, int dy, int[] consumed) { super.onNestedPreScroll(coordinatorLayout, child, target, dx, dy, consumed); if (child.getTop() <= initOffset && child.getTop() >= minOffset) { consumed[1] = Utils.scroll(child, dy, minOffset, initOffset); saveTop(child.getTop()); } } @Override public void onStopNestedScroll(final CoordinatorLayout parent, final RecyclerView child, View target) { Log.e("ldf","onStopNestedScroll"); super.onStopNestedScroll(parent, child, target); if (!Utils.isScrollToBottom()) { if (initOffset - Utils.loadTop() > Utils.getTouchSlop(context)){ scrollTo(parent, child, minOffset, 200); } else { scrollTo(parent, child, initOffset, 80); } } else { if (Utils.loadTop() - minOffset > Utils.getTouchSlop(context)){ scrollTo(parent, child, initOffset, 200); } else { scrollTo(parent, child, minOffset, 80); } } }
- (2)MonthPagerBehavior 当recyclerView滑动式,MonthPager做相应的变化。
@Override public boolean onDependentViewChanged(CoordinatorLayout parent, MonthPager child, View dependency) { Log.e("ldf","onDependentViewChanged"); CalendarViewAdapter calendarViewAdapter = (CalendarViewAdapter) child.getAdapter(); if (dependentViewTop != -1) { int dy = dependency.getTop() - dependentViewTop; //dependency对其依赖的view(本例依赖的view是RecycleView) int top = child.getTop(); if( dy > touchSlop){ calendarViewAdapter.switchToMonth(); } else if(dy < - touchSlop){ calendarViewAdapter.switchToWeek(child.getRowIndex()); } if (dy > -top){ dy = -top; } if (dy < -top - child.getTopMovableDistance()){ dy = -top - child.getTopMovableDistance(); } child.offsetTopAndBottom(dy); } else { initRecyclerViewTop = dependency.getTop(); } dependentViewTop = dependency.getTop(); top = child.getTop(); if((initRecyclerViewTop - dependentViewTop) >= child.getCellHeight()) { Utils.setScrollToBottom(false); calendarViewAdapter.switchToWeek(child.getRowIndex()); initRecyclerViewTop = dependentViewTop; } if((dependentViewTop - initRecyclerViewTop) >= child.getCellHeight()) { Utils.setScrollToBottom(true); calendarViewAdapter.switchToMonth(); initRecyclerViewTop = dependentViewTop; } return true; // TODO: 16/12/8 dy为负时表示向上滑动,dy为正时表示向下滑动,dy为零时表示滑动停止 }
- 使用IDayRender来实现自定义的日历效果
DayView实现IDayRenderer,我们新建一个CustomDayView继承自DayView,在里面作自定义的显示
public CustomDayView(Context context, int layoutResource) { super(context, layoutResource); dateTv = (TextView) findViewById(R.id.date); marker = (ImageView) findViewById(R.id.maker); selectedBackground = findViewById(R.id.selected_background); todayBackground = findViewById(R.id.today_background); } @Override public void refreshContent() { renderToday(day.getDate()); renderSelect(day.getState()); renderMarker(day.getDate(), day.getState()); super.refreshContent(); }
使用方法
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 , Calendar.MONTH_TYPE , 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 , Calendar.MONTH_TYPE , 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:v1.3.1' }
Licence
Copyright 2017 MagicMashRoom, Inc.
作者:神奇的小蘑菇
链接:http://www.jianshu.com/p/8e3fc46e5a80
來源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。
阅读全文
0 0
- 可能是第十好的Android 开源 日历 Calendar 仿小米
- 可能是第十好的Android 开源 日历 Calendar 仿小米
- Android日历 仿小米 华为 滴答清单 365日历,周视图 月视图 平滑滚动 week or month calendar
- 仿小米日历
- 高仿小米日历
- 仿小米和iphone日历效果,基于Android week view
- android 仿小米日历 周视图 月视图切换
- 仿小米,Cal日历的周月切换
- android高仿钉钉和小米的日历控件
- Calendar日历的使用
- android仿小米时钟
- Android仿IOS日历
- Android日历(Calendar,dataPicker)
- Android中的Calendar日历控件
- Android Calendar Provider(日历事件)
- 让你的小米5纵享丝滑,可能是最快的小米5rom
- 一些关于Calendar使用,Android坑爹的日历
- 日历Calendar控件的使用
- 欢迎使用CSDN-markdown编辑器
- Python3 数据结构与算法之枚举
- Struts2 拦截器
- HTML 表单,单选框,复选框,下拉列表,<textarea>
- 准确MainActivity
- 可能是第十好的Android 开源 日历 Calendar 仿小米
- CSR1010蓝牙模块_模块特点及技术指标
- C# 结构,枚举
- 网康上网行为管理NI3200-50
- cad快速看图电脑版使用
- git push时报10053
- 线程池
- xsd文档详解
- 如何使用Windows ADK 制作Windows 10 Preinstallation Environment(Windows 10 PE)