CalendarView

一个Android日历控件库，包含年历，月历，滚动月历，以及一个实现了年历、月历过渡的控件。它们既可以单独使用，也可以组合使用。 主要特点是包含丰富的自定义属性；年历月历可以为某一天添加各种样式的decorator。支持android api 11以上。

Thanks for ScrollerCalendar, a material style calendar widget library, contains some widget, you can be use them alone, also you can use them in combination. For Android api level 11+.

---

GIF预览：

---

• 主要功能简介
• 添加到项目中
• 主要API
• 接下来的工作
• 关于作者

---

主要功能简介

• 包含年历，月历。并且每个控件都有全方面的自定义属性。
• 为某一天添加自定义文字样式和背景。
• 包含滚动月历。支持滑动显示其它月份。
• 支持多种监听。
• 类似小米日历实现的，月历和周历上滑切换功能。
• 支持disable；禁选，单选，多选，范围选择。
• 提供一个帮助实现年历到月历的过渡动画的viewgroup。

---

添加到项目中

Android Studio用户，在项目的build.gradle中添加该dependencies：

compile "com.missmess.calendarview:calendarview:2.5.3"

从2.2.0及以下升级到2.4.0的请注意： 1、由于2.4.0增加了控件对多选和范围选择的支持。原来MonthView中跟selection相关的方法有部分已经被删除或者修改。 2、同样由于对多选的支持。周历滑动时，由于要保留多选模式下的selections，控件不再默认选中下一周的某一天，这里跟小米日历已经不一样了。其它方面在实现时已经尽量保持一致。

---

主要API

介绍一下主要的控件和api，更详细的可以下载demo来了解~

1、YearView

年历，显示一年的所有日期。YearView提供了16个自定义属性，用于完全定义你想要的布局：

    <declare-styleable name="YearView">
        <attr name="showYearLabel" format="boolean"/>
        <attr name="showYearLunarLabel" format="boolean"/>
        <attr name="dividerColor" format="color"/>
        <attr name="yearHeaderTextColor" format="color" />
        <attr name="yearHeaderTextHeight" format="dimension"/>
        <attr name="yearHeaderTextSize" format="dimension"/>
        <attr name="yearHeaderLunarTextColor" format="color"/>
        <attr name="yearHeaderLunarTextSize" format="dimension"/>
        <attr name="yearHeaderDashColor" format="color"/>
        <attr name="monthLabelTextColor" format="color"/>
        <attr name="monthLabelTextSize" format="dimension"/>
        <attr name="monthLabelTextHeight" format="dimension"/>
        <attr name="dayLabelTextColor" format="color"/>
        <attr name="dayLabelTextSize" format="dimension"/>
        <attr name="dayLabelRowHeight" format="dimension"/>
        <attr name="dayLabelCircleRadius" format="dimension"/>
    </declare-styleable>

可以通过setDecors方法为YearView设置decorators。setDecors方法对于其它的控件都可用。详细见 这里 。

	yearView.setToday(new CalendarDay(2017, 2, 12));
	DayDecor dayDecor = new DayDecor();
	dayDecor.putOne(new CalendarDay(2017, 1, 1), Color.GREEN);
	yearView.setDecors(dayDecor);

截图：

2、MonthView

月历。提供了17个自定义属性来控制MonthView布局。

  <declare-styleable name="MonthView">
      <attr name="dayCircleRadius" format="dimension" />
  	<attr name="selectDayCircleBgColor" format="color" />
  	<attr name="dayTextColor" format="color"/>
  	<attr name="dayDisableTextColor" format="color"/>
  	<attr name="dayTextSize" format="dimension"/>
  	<attr name="dayRowHeight" format="dimension" />
  	<attr name="firstDayOfWeek" format="integer" />
  	<attr name="monthTitleColor" format="color" />
  	<attr name="monthTextSize" format="dimension" />
  	<attr name="monthHeaderHeight" format="dimension" />
  	<attr name="weekLabelTextColor" format="color" />
  	<attr name="weekLabelTextSize" format="dimension" />
  	<attr name="weekLabelPadding" format="dimension" />
  	<attr name="showWeekLabel" format="boolean"/>
  	<attr name="showWeekDivider" format="boolean"/>
  	<attr name="showMonthTitle" format="boolean"/>
  	<attr name="weekMode" format="boolean"/>
  </declare-styleable>

截图：

3、MonthViewPager

可滚动的月历，左右滑动或点击indicator切换显示的月份。

使用MonthViewPager需要在xml中为它设置一个子view。这个子view只可以用来添加属性，但是不可以通过findViewById使用它。这个子view仅用作定义样式。

截图：

4、TransitRootView

这个viewgroup用来控制年历和月历之间的过渡。在xml中需要使用TransitRootView作为根布局，增加两个子view或viewgroup，它们分别包含你的YearView和MonthView（或者MonthViewPager）。 顺序不能颠倒，否则达不到指定的效果。详见demo。

提供了多个自定义属性用来控制过渡过程：

<declare-styleable name="TransitRootView">
    <attr name="y2m_interpolator" format="reference" />
    <attr name="m2y_interpolator" format="reference" />
    <attr name="y_anim_duration" format="integer" />
    <attr name="transit_base_duration" format="integer" />
    <attr name="m_anim_duration" format="integer" />
</declare-styleable>

5、DayDecor和Style

DayDecor可以为某一个显示的天，添加多种样式的Decorator或定义文字样式。示例：

  // add decorators
  DayDecor dayDecor = new DayDecor();
  // circle bg
  dayDecor.putOne(new CalendarDay(2017, 2, 1), 0xFFFF6600);
  // rectangle bg
  int color = 0xFFAAAAAA;
  dayDecor.putOne(new CalendarDay(2017, 2, 4), color, DayDecor.Style.RECTANGLE);
  dayDecor.putOne(new CalendarDay(2017, 2, 11), color, DayDecor.Style.RECTANGLE);
  dayDecor.putOne(new CalendarDay(2017, 2, 18), color, DayDecor.Style.RECTANGLE);
  dayDecor.putOne(new CalendarDay(2017, 2, 25), color, DayDecor.Style.RECTANGLE);
  // drawable bg
  dayDecor.putOne(new CalendarDay(2017, 2, 19), getResources().getDrawable(R.drawable.a_decor));
  // styled background and text
  DayDecor.Style style = new DayDecor.Style();
  style.setTextSize(getResources().getDimensionPixelSize(R.dimen.big_text));
  style.setTextColor(0xFF72E6BC);
  style.setBold(true);
  style.setItalic(true);
  style.setUnderline(true);
  style.setStrikeThrough(true);
  style.setPureColorBgShape(DayDecor.Style.CIRCLE);
  style.setPureColorBg(0xFF66AA76);
  dayDecor.putOne(new CalendarDay(2017, 2, 24), style);
  monthView.setDecors(dayDecor);

6、周历到月历切换

1、支持月历周历的竖直滑动切换。需要配合nested scrolling。示例：

    <!-- 顶层需使用CoordinatorLayout -->
    <android.support.design.widget.CoordinatorLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <com.missmess.calendarview.MonthViewPager
            android:id="@+id/mvp"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            calendar:ic_next_month="@mipmap/right_icon"
            calendar:ic_previous_month="@mipmap/left_icon"
            calendar:month_marginTop="0dp"
            calendar:otherMonthTextColor="#CCCCCC"
            calendar:showOtherMonth="true"
            calendar:show_indicator="false">

            <com.missmess.calendarview.MonthView
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                calendar:showMonthTitle="false"
                calendar:showWeekDivider="false"
                calendar:dayRowHeight="50dp"
                calendar:showWeekLabel="false"/>

        </com.missmess.calendarview.MonthViewPager>

		  <!-- 这个view将覆盖MonthViewPager，并且需要支持nested scrolling -->
		  <!-- 需要增加behavior,  使用@string/monthViewPager_scroll_behavior-->
        <android.support.v4.widget.NestedScrollView
            android:id="@+id/scrollView"
            android:layout_width="match_parent"
            calendar:layout_behavior="@string/monthViewPager_scroll_behavior"
            android:background="@android:color/white"
            android:layout_height="match_parent" >

            <TextView
                android:id="@+id/tv"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:gravity="center"
                android:padding="15dp"
                android:text="@string/no_event"
                android:textSize="20sp"/>

        </android.support.v4.widget.NestedScrollView>
    </android.support.design.widget.CoordinatorLayout>

2、如果不需要嵌套垂直滑动切换week/month mode。则不要使用behavior即可。同时提供直接在代码中进行切换。

		if(monthViewPager.isMonthMode()) {
  		monthViewPager.setWeekMode();
  	} else {
  		monthViewPager.setMonthMode();
  	}

通过上述步骤就能实现周历、月历切换功能。

---

接下来的工作

还有一些工作需要完善：

1、 强化DayDecor的功能，包括对样式（加粗、斜体），任意背景，任意字体颜色的自定义。

2、 增加月历上滑显示到周历的功能。类似于小米日历的效果。

3、周历上切换时，默认设置selection也根据切换变化。

4、设置某一天disable属性

---

关于作者

有任何问题和BUG，欢迎反馈给我，可以用以下联系方式跟我交流：

• 邮箱：[email protected]
• GitHub: @missmess

---

CopyRight：missmess