# CalendarView **Repository Path**: vipvvitt/CalendarView ## Basic Information - **Project Name**: CalendarView - **Description**: Android上一个优雅、高度自定义、性能高效的日历控件,支持标记、自定义颜色、农历等。Canvas绘制,速度快、占用内存低 - **Primary Language**: Android - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 181 - **Created**: 2017-12-12 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # CalenderView Android上一个优雅、高度自定义、性能高效的日历控件,完美支持周视图,支持标记、自定义颜色、农历等。Canvas绘制,速度快、占用内存低,3.0.0版本全新重构,支持简单重新即可实现任意自定义布局、自定义UI,支持收缩展开、性能非常高效, 这个控件内存和效率优势相当明显,而且真正做到收缩+展开,适配多种场景,支持同时多种颜色标记日历事务,更多参考用法请移步Demo,Demo实现了4个精美的自定义效果。 ### Gradle ``` compile 'com.haibin:calendarview:3.0.1' ``` ``` com.haibin calendarview 3.0.1 pom ``` ### 如果你需要完全定制UI,参考demo,简单几步即可绘制你需要的效果,一般只需要实现三个回调函数绘制你需要的特效即可,自定义日历UI需要同时自定义周视图,真正做到热插拔效果,方便大众定制UI需求 ### 效果预览 ### 收缩展开的魅族风格效果       ### 下标和多彩风格       ### 快速年份月份切换       ### 使用方法 ```xml ``` ### attrs ```xml                     ``` ### CalendarView api ```java public int getCurDay(); //今天 public int getCurMonth(); //当前的月份 public int getCurYear(); //今年 public void showSelectLayout(final int year); //快速弹出年份选择月份 public void closeSelectLayout(final int position); //关闭选择年份并跳转日期 public void setOnDateChangeListener(OnDateChangeListener listener);//添加事件 public void setOnDateSelectedListener(OnDateSelectedListener listener);//日期选择事件 public void setSchemeDate(List mSchemeDate);//标记日期 public void update();//动态更新 public Calendar getSelectedCalendar(); //获取选择的日期 /** * 设置背景色 * * @param monthLayoutBackground 月份卡片的背景色 * @param weekBackground 星期栏背景色 * @param lineBg 线的颜色 */ public void setBackground(int monthLayoutBackground, int weekBackground, int lineBg) /** * 设置文本颜色 * * @param curMonthTextColor 当前月份字体颜色 * @param otherMonthColor 其它月份字体颜色 * @param lunarTextColor 农历字体颜色 */ public void setTextColor(int curMonthTextColor,int otherMonthColor,int lunarTextColor) /** * 设置选择的效果 * * @param style 选中的style CalendarCardView.STYLE_FILL or CalendarCardView.STYLE_STROKE * @param selectedThemeColor 选中的标记颜色 * @param selectedTextColor 选中的字体颜色 */ public void setSelectedColor(int style, int selectedThemeColor, int selectedTextColor) /** * 设置标记的色 * * @param style 标记的style CalendarCardView.STYLE_FILL or CalendarCardView.STYLE_STROKE * @param schemeColor 标记背景色 * @param schemeTextColor 标记字体颜色 */ public void setSchemeColor(int style, int schemeColor, int schemeTextColor) /** * 设置星期栏的背景和字体颜色 * * @param weekBackground 背景色 * @param weekTextColor 字体颜色 */ public void setWeeColor(int weekBackground, int weekTextColor) ``` ### CalendarLayout api ```java public void expand(); //展开 public void shrink(); //收缩 ``` ### 如果你需要完全定制UI,参考demo,简单几步即可绘制你需要的效果,月视图和周视图需要同时更换,达到UI一致 #### 首先绘制月视图 ```java public class SimpleCalendarCardView extends BaseCalendarCardView { private int mRadius; public SimpleCalendarCardView(Context context) { super(context); } @Override protected void onPreviewHook() { mRadius = Math.min(mItemWidth, mItemHeight) / 5 * 2; mSchemePaint.setStyle(Paint.Style.STROKE); } @Override protected void onLoopStart(int x, int y) { } @Override protected void onDrawSelected(Canvas canvas, Calendar calendar, int x, int y, boolean hasScheme) { int cx = x + mItemWidth / 2; int cy = y + mItemHeight / 2; canvas.drawCircle(cx, cy, mRadius, mSelectedPaint); } @Override protected void onDrawScheme(Canvas canvas, Calendar calendar, int x, int y) { int cx = x + mItemWidth / 2; int cy = y + mItemHeight / 2; canvas.drawCircle(cx, cy, mRadius, mSchemePaint); } @Override protected void onDrawText(Canvas canvas, Calendar calendar, int x, int y, boolean hasScheme, boolean isSelected) { float baselineY = mTextBaseLine + y; int cx = x + mItemWidth / 2; if (hasScheme) { canvas.drawText(String.valueOf(calendar.getDay()), cx, baselineY, calendar.isCurrentDay() ? mCurDayTextPaint : calendar.isCurrentMonth() ? mSchemeTextPaint : mOtherMonthTextPaint); } else { canvas.drawText(String.valueOf(calendar.getDay()), cx, baselineY, calendar.isCurrentDay() ? mCurDayTextPaint : calendar.isCurrentMonth() ? mCurMonthTextPaint : mOtherMonthTextPaint); } } } ``` #### 其次绘制周视图,周视图回调几乎一样,唯一的区别是不需要y,只有一行,所以可以直接拷贝代码,把y=0即可 public class SimpleWeekView extends WeekView{ private int mRadius; public SimpleWeekView(Context context) { super(context); } @Override protected void onPreviewHook() { mRadius = Math.min(mItemWidth, mItemHeight) / 5 * 2; mSchemePaint.setStyle(Paint.Style.STROKE); } @Override protected void onDrawSelected(Canvas canvas, Calendar calendar, int x, boolean hasScheme) { int cx = x + mItemWidth / 2; int cy = mItemHeight / 2; canvas.drawCircle(cx, cy, mRadius, mSelectedPaint); } @Override protected void onDrawScheme(Canvas canvas, Calendar calendar, int x) { int cx = x + mItemWidth / 2; int cy = mItemHeight / 2; canvas.drawCircle(cx, cy, mRadius, mSchemePaint); } @Override protected void onDrawText(Canvas canvas, Calendar calendar, int x, boolean hasScheme, boolean isSelected) { float baselineY = mTextBaseLine ; int cx = x + mItemWidth / 2; if (hasScheme) { canvas.drawText(String.valueOf(calendar.getDay()), cx, baselineY, calendar.isCurrentDay() ? mCurDayTextPaint : calendar.isCurrentMonth() ? mSchemeTextPaint : mSchemeTextPaint); } else { canvas.drawText(String.valueOf(calendar.getDay()), cx, baselineY, calendar.isCurrentDay() ? mCurDayTextPaint : calendar.isCurrentMonth() ? mCurMonthTextPaint : mCurMonthTextPaint); } } } ## Licenses - Copyright (C) 2013 huanghaibin_dev - 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.