Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Android上一个优雅、万能自定义UI、支持周视图、自定义周起始、性能高效的日历控件,支持热插拔实现的UI定制!支持标记、自定义颜色、农历、自定义月视图各种显示模式等。Canvas绘制,速度快、占用内存低,你真的想不到日历居然还可以如此优雅!An elegant, highly customized and high-performance Calendar Widget on Android.

License

Notifications You must be signed in to change notification settings

champion32/CalendarView

Repository files navigation

CalenderView

Android上一个优雅、高度自定义、性能高效的日历控件,完美支持周视图,支持标记、自定义颜色、农历等,任意控制月视图显示、任意日期拦截条件、自定义周起始等。Canvas绘制,极速性能、占用内存低,,支持简单定制即可实现任意自定义布局、自定义UI,支持收缩展开、性能非常高效, 这个控件内存和效率优势相当明显,而且真正做到收缩+展开,适配多种场景,支持同时多种颜色标记日历事务,支持多点触控,你真的想不到日历还可以如此优雅!更多参考用法请移步Demo,Demo实现了4个精美的自定义效果。

English Version

详细介绍

Gradle

compile 'com.haibin:calendarview:3.4.7'
<dependency>
 <groupId>com.haibin</groupId>
 <artifactId>calendarview</artifactId>
 <version>3.4.7</version>
 <type>pom</type>
</dependency>

混淆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);
}

效果预览

功能性展示

年视图和范围选择风格

中国式变态需求风格

收缩展开的魅族风格效果

下标和多彩风格

进度条风格

星系图风格

特别的,请注意不要复制这三个路径,自行替换您自己的自定义路径

app:month_view="com.haibin.calendarviewproject.simple.SimpleCalendarCardView"
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" /><!--日历内部左右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" /><!--内容布局id-->

Licenses

  • Copyright (C) 2013 huanghaibin_dev huanghaibin_dev@163.com

  • 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.

About

Android上一个优雅、万能自定义UI、支持周视图、自定义周起始、性能高效的日历控件,支持热插拔实现的UI定制!支持标记、自定义颜色、农历、自定义月视图各种显示模式等。Canvas绘制,速度快、占用内存低,你真的想不到日历居然还可以如此优雅!An elegant, highly customized and high-performance Calendar Widget on Android.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 100.0%

AltStyle によって変換されたページ (->オリジナル) /