Android自定義優雅、性能高效的日曆控件

Adroid自定義優雅、性能高效的日曆控件,完美支持周視圖,支持標記、自定義顏色、農曆等,任意控制月視圖顯示、任意日期攔截條件、自定義周起始等。Canvas繪製,極速性能、佔用內存低,,支持簡單定製便可實現任意自定義佈局、自定義UI,支持收縮展開、性能很是高效, 這個控件內存和效率優點至關明顯,並且真正作到收縮+展開,適配多種場景,支持同時多種顏色標記日曆事務,支持多點觸控,你真的想不到日曆還能夠如此優雅!更多參考用法請移步Demo,Demo實現了4個精美的自定義效果。java

dependencies {

implementation 'com.github.Visen123:CalendarView:V1.0'

}

混淆proguard-rules
-keepclasseswithmembers class * {
public <init>(android.content.Context);
}
或者針對性的使用混淆
-keep class your project path.MonthView {
public <init>(android.content.Context);
}
-keep class your project path.WeekBar {
public <init>(android.content.Context);
}
-keep class your project path.WeekView {
public <init>(android.content.Context);
}android

特別的,請注意不要複製這三個路徑,自行替換您本身的自定義路徑

app:month_view="com.yanyiyun.calendarviewproject.simple.SimpleCalendarCardView"
app:week_view="com.yanyiyun.calendarviewproject.simple.SimpleWeekView"
app:week_bar_view="com.yanyiyun.calendarviewproject.EnglishWeekBar"
使用方法
 <com.yanyiyun.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.yanyiyun.calendarview.CalendarView
             android:id="@+id/calendarView"
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
             android:background="#fff"
             app:month_view="com.yanyiyun.calendarviewproject.simple.SimpleCalendarCardView"
             app:week_view="com.yanyiyun.calendarviewproject.simple.SimpleWeekView"
             app:week_bar_view="com.yanyiyun.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.yanyiyun.calendarview.CalendarLayout>
CalendarView attrs
<declare-styleable name="CalendarView">

        <attr name="calendar_padding" format="dimension" /><!--日曆內部左右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設置無效,當仍可java api設置-->
        <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" /><!--今天的農曆文本顏色-->

        <attr name="calendar_height" format="string" /> <!--日曆每項的高度,56dp-->
        <attr name="day_text_size" format="string" /> <!--天數文本大小-->
        <attr name="lunar_text_size" format="string" /> <!--農曆文本大小-->

        <attr name="scheme_text" format="string" /> <!--標記文本-->
        <attr name="scheme_text_color" format="color" /> <!--標記文本顏色-->
        <attr name="scheme_month_text_color" format="color" /> <!--標記天數文本顏色-->
        <attr name="scheme_lunar_text_color" format="color" /> <!--標記農曆文本顏色-->

        <attr name="scheme_theme_color" format="color" /> <!--標記的顏色-->

        <attr name="selected_theme_color" format="color" /> <!--選中顏色-->
        <attr name="selected_text_color" format="color" /> <!--選中文本顏色-->
        <attr name="selected_lunar_text_color" format="color" /> <!--選中農曆文本顏色-->

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

        <attr name="current_month_lunar_text_color" format="color" /> <!--當前月份農曆節假日顏色-->
        <attr name="other_month_lunar_text_color" format="color" /> <!--其它月份農曆節假日顏色-->

        <!-- 年視圖相關 -->
        <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" /> <!-- 年視圖標記顏色 -->

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

        <!--月視圖是否可滾動-->
        <attr name="month_view_scrollable" format="boolean" />
        <!--周視圖是否可滾動-->
        <attr name="week_view_scrollable" format="boolean" />
        <!--年視圖是否可滾動-->
        <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" /> <!--僅顯示當前月份-->
             <enum name="mode_fix" value="2" /> <!--自適應顯示,不會多出一行,可是會自動填充-->
        </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>

        <!-- 當 select_mode=range_mode -->
        <attr name="min_select_range" format="integer" />
        <attr name="max_select_range" format="integer" />
</declare-styleable>
CalendarView api
public void setRange(int minYear, int minYearMonth, int minYearDay,
                     int maxYear, int maxYearMonth, int maxYearDay) ;//置日期範圍

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

public boolean isYearSelectLayoutVisible();//年月份選擇視圖是否打開
public void closeYearSelectLayout();//關閉年月視圖選擇佈局
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);//標記日期

public void update();//動態更新

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

/**
 * 特別的,若是你須要自定義或者使用其它選擇器,能夠用如下方法進行和日曆聯動
 */
public void scrollToCurrent();//滾動到當前日期

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

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

public void scrollToPre();//滾動到上一個月

public void scrollToNext();//滾動到下一個月

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

public Calendar getMinRangeCalendar();//得到最小範圍日期

public Calendar getMaxRangeCalendar();//得到最大範圍日期

/**
  * 設置背景色
  *
  * @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
public void expand(); //展開

public void shrink(); //收縮

public boolean isExpand();//是否展開了
CalendarLayout attrs
<!-- 日曆顯示模式 -->
<attr name="calendar_show_mode">
      <enum name="both_month_week_view" value="0" /><!-- 默認都有 -->
      <enum name="only_week_view" value="1" /><!-- 僅周視圖 -->
      <enum name="only_month_view" value="2" /><!-- 僅月視圖 -->
</attr>

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

<attr name="calendar_content_view_id" format="integer" />

<項目地址:https://github.com/Visen123/CalendarView>
相關文章
相關標籤/搜索