CalenderView是Android上一個(gè)優(yōu)雅、高度自定義、性能高效的日歷控件，完美支持周視圖，支持標(biāo)記、自定義顏色、農(nóng)歷等，任意控制月視圖顯示、任意日期攔截條件、自定義周起始等。Canvas繪制，極速性能、占用內(nèi)存低，，支持簡單定制即可實(shí)現(xiàn)任意自定義布局、自定義UI，支持收縮展開、性能非常高效， 這個(gè)控件內(nèi)存和效率優(yōu)勢相當(dāng)明顯，而且真正做到收縮+展開，適配多種場景，支持同時(shí)多種顏色標(biāo)記日歷事務(wù)，支持多點(diǎn)觸控，你真的想不到日歷還可以如此優(yōu)雅!

插拔式設(shè)計(jì)

插拔式設(shè)計(jì)：好比插座一樣，插上燈泡就會亮，插上風(fēng)扇就會轉(zhuǎn)，看用戶需求什么而不是看插座有什么，只要是電器即可。

此框架使用插拔式，既可以在編譯時(shí)指定年月日視圖，如：

app:month_view="xxx.xxx.MonthView.class"，

也可在運(yùn)行時(shí)動(dòng)態(tài)更換年月日視圖，如：

CalendarView.setMonthViewClass(MonthView.Class)，

從而達(dá)到UI即插即用的效果，相當(dāng)于框架不提供UI實(shí)現(xiàn)，讓UI都由客戶端實(shí)現(xiàn)，不至于日歷UI都千篇一律，只需遵守插拔式接口即可隨意定制，自由化程度非常高。

效果預(yù)覽

功能性展示

年視圖和范圍選擇風(fēng)格

中國式變態(tài)需求風(fēng)格

收縮展開的魅族風(fēng)格效果a

全屏和多彩風(fēng)格

進(jìn)度條風(fēng)格

星系圖風(fēng)格

特別的，請注意不要復(fù)制這三個(gè)路徑，自行替換您自己的自定義路徑

 app:month_view="com.haibin.calendarviewproject.simple.SimpleMonthView"
app:week_view="com.haibin.calendarviewproject.simple.SimpleWeekView"
app:week_bar_view="com.haibin.calendarviewproject.EnglishWeekBar"

使用方法

<com.haibin.calendarview.CalendarLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
app:default_status="shrink"
app:calendar_show_mode="only_week_view"
app:calendar_content_view_id="@+id/recyclerView">

<com.haibin.calendarview.CalendarView
android:id="@+id/calendarView"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="#fff"
app:month_view="com.haibin.calendarviewproject.simple.SimpleCalendarCardView"
app:week_view="com.haibin.calendarviewproject.simple.SimpleWeekView"
app:week_bar_view="com.haibin.calendarviewproject.EnglishWeekBar"
app:calendar_height="50dp"
app:current_month_text_color="#333333"
app:current_month_lunar_text_color="#CFCFCF"
app:min_year="2004"
app:other_month_text_color="#e1e1e1"
app:scheme_text="假"
app:scheme_text_color="#333"
app:scheme_theme_color="#333"
app:selected_text_color="#fff"
app:selected_theme_color="#333"
app:week_start_with="mon"
app:week_background="#fff"
app:month_view_show_mode="mode_only_current"
app:week_text_color="#111" />

<android.support.v7.widget.RecyclerView
android:id="@+id/recyclerView"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="#d4d4d4" />
</com.haibin.calendarview.CalendarLayout>

CalendarView attrs

<declare-styleable name="CalendarView">        <attr name="calendar_padding" format="dimension" /><!--日歷內(nèi)部左右padding-->        <attr name="month_view" format="color" /> <!--自定義類日歷月視圖路徑-->        <attr name="week_view" format="string" /> <!--自定義類周視圖路徑-->        <attr name="week_bar_height" format="dimension" /> <!--星期欄的高度-->        <attr name="week_bar_view" format="color" /> <!--自定義類周欄路徑，通過自定義則 week_text_color week_background xml設(shè)置無效，當(dāng)仍可java api設(shè)置-->        <attr name="week_line_margin" format="dimension" /><!--線條margin-->        <attr name="week_line_background" format="color" /><!--線條顏色-->        <attr name="week_background" format="color" /> <!--星期欄的背景-->        <attr name="week_text_color" format="color" /> <!--星期欄文本顏色-->        <attr name="week_text_size" format="dimension" /><!--星期欄文本大小-->        <attr name="current_day_text_color" format="color" /> <!--今天的文本顏色-->        <attr name="current_day_lunar_text_color" format="color" /><!--今天的農(nóng)歷文本顏色-->        <attr name="calendar_height" format="string" /> <!--日歷每項(xiàng)的高度，56dp-->        <attr name="day_text_size" format="string" /> <!--天數(shù)文本大小-->        <attr name="lunar_text_size" format="string" /> <!--農(nóng)歷文本大小-->        <attr name="scheme_text" format="string" /> <!--標(biāo)記文本-->        <attr name="scheme_text_color" format="color" /> <!--標(biāo)記文本顏色-->        <attr name="scheme_month_text_color" format="color" /> <!--標(biāo)記天數(shù)文本顏色-->        <attr name="scheme_lunar_text_color" format="color" /> <!--標(biāo)記農(nóng)歷文本顏色-->        <attr name="scheme_theme_color" format="color" /> <!--標(biāo)記的顏色-->        <attr name="selected_theme_color" format="color" /> <!--選中顏色-->        <attr name="selected_text_color" format="color" /> <!--選中文本顏色-->        <attr name="selected_lunar_text_color" format="color" /> <!--選中農(nóng)歷文本顏色-->        <attr name="current_month_text_color" format="color" /> <!--當(dāng)前月份的字體顏色-->        <attr name="other_month_text_color" format="color" /> <!--其它月份的字體顏色-->        <attr name="current_month_lunar_text_color" format="color" /> <!--當(dāng)前月份農(nóng)歷節(jié)假日顏色-->        <attr name="other_month_lunar_text_color" format="color" /> <!--其它月份農(nóng)歷節(jié)假日顏色-->        <!-- 年視圖相關(guān) -->        <attr name="year_view_month_text_size" format="dimension" /> <!-- 年視圖月份字體大小 -->        <attr name="year_view_day_text_size" format="dimension" /> <!-- 年視圖月份日期字體大小 -->        <attr name="year_view_month_text_color" format="color" /> <!-- 年視圖月份字體顏色 -->        <attr name="year_view_day_text_color" format="color" /> <!-- 年視圖日期字體顏色 -->        <attr name="year_view_scheme_color" format="color" /> <!-- 年視圖標(biāo)記顏色 -->        <attr name="min_year" format="integer" />  <!--最小年份1900-->        <attr name="max_year" format="integer" />  <!--最大年份2099-->        <attr name="min_year_month" format="integer" /> <!--最小年份對應(yīng)月份-->        <attr name="max_year_month" format="integer" /> <!--最大年份對應(yīng)月份-->        <!--月視圖是否可滾動(dòng)-->        <attr name="month_view_scrollable" format="boolean" />        <!--周視圖是否可滾動(dòng)-->        <attr name="week_view_scrollable" format="boolean" />        <!--年視圖是否可滾動(dòng)-->        <attr name="year_view_scrollable" format="boolean" />                <!--配置你喜歡的月視圖顯示模式模式-->        <attr name="month_view_show_mode">             <enum name="mode_all" value="0" /> <!--全部顯示-->             <enum name="mode_only_current" value="1" /> <!--僅顯示當(dāng)前月份-->             <enum name="mode_fix" value="2" /> <!--自適應(yīng)顯示，不會多出一行，但是會自動(dòng)填充-->        </attr>        <!-- 自定義周起始 -->        <attr name="week_start_with">             <enum name="sun" value="1" />             <enum name="mon" value="2" />             <enum name="sat" value="7" />        </attr>        <!-- 自定義選擇模式 -->        <attr name="select_mode">              <enum name="default_mode" value="0" />              <enum name="single_mode" value="1" />              <enum name="range_mode" value="2" />        </attr>        <!-- 當(dāng) select_mode=range_mode -->        <attr name="min_select_range" format="integer" />        <attr name="max_select_range" format="integer" /></declare-styleable>

CalendarView api

 <declare-styleable name="CalendarView">

<attr name="calendar_padding" format="dimension" /><!--日歷內(nèi)部左右padding-->

<attr name="month_view" format="color" /> <!--自定義類日歷月視圖路徑-->
<attr name="week_view" format="string" /> <!--自定義類周視圖路徑-->
<attr name="week_bar_height" format="dimension" /> <!--星期欄的高度-->
<attr name="week_bar_view" format="color" /> <!--自定義類周欄路徑，通過自定義則 week_text_color week_background xml設(shè)置無效，當(dāng)仍可java api設(shè)置-->
<attr name="week_line_margin" format="dimension" /><!--線條margin-->

<attr name="week_line_background" format="color" /><!--線條顏色-->
<attr name="week_background" format="color" /> <!--星期欄的背景-->
<attr name="week_text_color" format="color" /> <!--星期欄文本顏色-->
<attr name="week_text_size" format="dimension" /><!--星期欄文本大小-->

<attr name="current_day_text_color" format="color" /> <!--今天的文本顏色-->
<attr name="current_day_lunar_text_color" format="color" /><!--今天的農(nóng)歷文本顏色-->

<attr name="calendar_height" format="string" /> <!--日歷每項(xiàng)的高度，56dp-->
<attr name="day_text_size" format="string" /> <!--天數(shù)文本大小-->
<attr name="lunar_text_size" format="string" /> <!--農(nóng)歷文本大小-->

<attr name="scheme_text" format="string" /> <!--標(biāo)記文本-->
<attr name="scheme_text_color" format="color" /> <!--標(biāo)記文本顏色-->
<attr name="scheme_month_text_color" format="color" /> <!--標(biāo)記天數(shù)文本顏色-->
<attr name="scheme_lunar_text_color" format="color" /> <!--標(biāo)記農(nóng)歷文本顏色-->

<attr name="scheme_theme_color" format="color" /> <!--標(biāo)記的顏色-->

<attr name="selected_theme_color" format="color" /> <!--選中顏色-->
<attr name="selected_text_color" format="color" /> <!--選中文本顏色-->
<attr name="selected_lunar_text_color" format="color" /> <!--選中農(nóng)歷文本顏色-->

<attr name="current_month_text_color" format="color" /> <!--當(dāng)前月份的字體顏色-->
<attr name="other_month_text_color" format="color" /> <!--其它月份的字體顏色-->

<attr name="current_month_lunar_text_color" format="color" /> <!--當(dāng)前月份農(nóng)歷節(jié)假日顏色-->
<attr name="other_month_lunar_text_color" format="color" /> <!--其它月份農(nóng)歷節(jié)假日顏色-->

<!-- 年視圖相關(guān) -->
<attr name="year_view_month_text_size" format="dimension" /> <!-- 年視圖月份字體大小 -->
<attr name="year_view_day_text_size" format="dimension" /> <!-- 年視圖月份日期字體大小 -->
<attr name="year_view_month_text_color" format="color" /> <!-- 年視圖月份字體顏色 -->
<attr name="year_view_day_text_color" format="color" /> <!-- 年視圖日期字體顏色 -->
<attr name="year_view_scheme_color" format="color" /> <!-- 年視圖標(biāo)記顏色 -->

<attr name="min_year" format="integer" /> <!--最小年份1900-->
<attr name="max_year" format="integer" /> <!--最大年份2099-->
<attr name="min_year_month" format="integer" /> <!--最小年份對應(yīng)月份-->
<attr name="max_year_month" format="integer" /> <!--最大年份對應(yīng)月份-->

<!--月視圖是否可滾動(dòng)-->
<attr name="month_view_scrollable" format="boolean" />
<!--周視圖是否可滾動(dòng)-->
<attr name="week_view_scrollable" format="boolean" />
<!--年視圖是否可滾動(dòng)-->
<attr name="year_view_scrollable" format="boolean" />

<!--配置你喜歡的月視圖顯示模式模式-->
<attr name="month_view_show_mode">
<enum name="mode_all" value="0" /> <!--全部顯示-->
<enum name="mode_only_current" value="1" /> <!--僅顯示當(dāng)前月份-->
<enum name="mode_fix" value="2" /> <!--自適應(yīng)顯示，不會多出一行，但是會自動(dòng)填充-->
</attr>

<!-- 自定義周起始 -->
<attr name="week_start_with">
<enum name="sun" value="1" />
<enum name="mon" value="2" />
<enum name="sat" value="7" />
</attr>

<!-- 自定義選擇模式 -->
<attr name="select_mode">
<enum name="default_mode" value="0" />
<enum name="single_mode" value="1" />
<enum name="range_mode" value="2" />
</attr>

<!-- 當(dāng) select_mode=range_mode -->
<attr name="min_select_range" format="integer" />
<attr name="max_select_range" format="integer" />
</declare-styleable>

CalendarLayout api

 public void setRange(int minYear, int minYearMonth, int minYearDay,
int maxYear, int maxYearMonth, int maxYearDay) ;//置日期范圍

public int getCurDay(); //今天
public int getCurMonth(); //當(dāng)前的月份
public int getCurYear(); //今年

public boolean isYearSelectLayoutVisible();//年月份選擇視圖是否打開
public void closeYearSelectLayout();//關(guān)閉年月視圖選擇布局
public void showYearSelectLayout(final int year); //快速彈出年份選擇月份

public void setOnMonthChangeListener(OnMonthChangeListener listener);//月份改變事件

public void setOnYearChangeListener(OnYearChangeListener listener);//年份切換事件

public void setOnCalendarSelectListener(OnCalendarSelectListener listener)//日期選擇事件

public void setOnCalendarLongClickListener(OnCalendarLongClickListener listener);//日期長按事件

public void setOnCalendarLongClickListener(OnCalendarLongClickListener listener, boolean preventLongPressedSelect);//日期長按事件

public void setOnCalendarInterceptListener(OnCalendarInterceptListener listener);//日期攔截和日期有效性繪制

public void setSchemeDate(Map<String, Calendar> mSchemeDates);//標(biāo)記日期

public void update();//動(dòng)態(tài)更新

public Calendar getSelectedCalendar(); //獲取選擇的日期

/**
* 特別的，如果你需要自定義或者使用其它選擇器，可以用以下方法進(jìn)行和日歷聯(lián)動(dòng)
*/
public void scrollToCurrent();//滾動(dòng)到當(dāng)前日期

public void scrollToCurrent(boolean smoothScroll);//滾動(dòng)到當(dāng)前日期

public void scrollToYear(int year);//滾動(dòng)到某一年

public void scrollToPre();//滾動(dòng)到上一個(gè)月

public void scrollToNext();//滾動(dòng)到下一個(gè)月

public void scrollToCalendar(int year, int month, int day);//滾動(dòng)到指定日期

public Calendar getMinRangeCalendar();//獲得最小范圍日期

public Calendar getMaxRangeCalendar();//獲得最大范圍日期

/**
* 設(shè)置背景色
*
* @param monthLayoutBackground 月份卡片的背景色
* @param weekBackground 星期欄背景色
* @param lineBg 線的顏色
*/
public void setBackground(int monthLayoutBackground, int weekBackground, int lineBg)

/**
* 設(shè)置文本顏色
*
* @param curMonthTextColor 當(dāng)前月份字體顏色
* @param otherMonthColor 其它月份字體顏色
* @param lunarTextColor 農(nóng)歷字體顏色
*/
public void setTextColor(int curMonthTextColor,int otherMonthColor,int lunarTextColor)

/**
* 設(shè)置選擇的效果
*
* @param style 選中的style CalendarCardView.STYLE_FILL or CalendarCardView.STYLE_STROKE
* @param selectedThemeColor 選中的標(biāo)記顏色
* @param selectedTextColor 選中的字體顏色
*/
public void setSelectedColor(int style, int selectedThemeColor, int selectedTextColor)

/**
* 設(shè)置標(biāo)記的色
*
* @param style 標(biāo)記的style CalendarCardView.STYLE_FILL or CalendarCardView.STYLE_STROKE
* @param schemeColor 標(biāo)記背景色
* @param schemeTextColor 標(biāo)記字體顏色
*/
public void setSchemeColor(int style, int schemeColor, int schemeTextColor)

/**
* 設(shè)置星期欄的背景和字體顏色
*
* @param weekBackground 背景色
* @param weekTextColor 字體顏色
*/
public void setWeeColor(int weekBackground, int weekTextColor)

CalendarLayout attrs

public void expand(); //展開

public void shrink(); //收縮

public boolean isExpand();//是否展開了
CalendarLayout attrs

<!-- 日歷顯示模式 -->
<attr name="calendar_show_mode">
<enum name="both_month_week_view" value="0" /><!-- 默認(rèn)都有 -->
<enum name="only_week_view" value="1" /><!-- 僅周視圖 -->
<enum name="only_month_view" value="2" /><!-- 僅月視圖 -->
</attr>

<attr name="default_status">
<enum name="expand" value="0" /> <!--默認(rèn)展開-->
<enum name="shrink" value="1" /><!--默認(rèn)搜索-->
</attr>

<attr name="calendar_content_view_id" format="integer" /><!--內(nèi)容布局id-->