Home

Awesome

EasyCalendar

Quickly customize the calendar UI. You can use EasyCalendar to quickly get the calendar style UI.

Feature

Screenshot

<img src="https://github.com/shichaohui/EasyCalendar/blob/master/screeshot/screenshot_main_gif.gif" width = "270" alt="默认样式" /> <img src="https://github.com/shichaohui/EasyCalendar/blob/master/screeshot/screenshot_action.jpg" width = "270" alt="自定义样式" />

<img src="https://github.com/shichaohui/EasyCalendar/blob/master/screeshot/screenshot_checkin_gif.gif" width = "270" alt="自定义样式" /> <img src="https://github.com/shichaohui/EasyCalendar/blob/master/screeshot/screenshot_checkin.jpg" width = "270" alt="自定义样式" />

Gradle

compile 'com.sch.calendar:easy-calendar:1.0.1'

Attributes

nameformatdescription
titleColorcolorset color for title
titleLayoutreferencecustom layout for title
weekColorcolorset color for week
weekBackgroundcolor|referenceset background for week bar
monthBackgroundcolor|referenceset backgroung for month layout
dateDividerColorcolorset color for divider of date
dateDividerSizedimensionset size for divider of date
imgLastMonthreferenceset image for button of last month
imgNextMonthreferenceset image for button of next month
languageenumchina: 中文, english: English

API

  1. Show or hide overflow date.
/**
 * If true, show whole calendar.
 * e.g. showing date is April, if show whole calendar, 03/30 and 05/01 will show.
 */
public void setShowOverflowDate(boolean showOverflowDate);

public boolean isShowOverflowDate();
  1. Set format for title.
/**
 * Constructs a <code>SimpleDateFormat</code> using the given pattern and
 * the default date format symbols for the given locale.
 * <b>Note:</b> This constructor may not support all locales.
 * For full coverage, use the factory methods in the {@link DateFormat}
 * class.
 *
 * @param pattern the pattern describing the date and time format
 * @param locale  the locale whose date format symbols should be used
 */
public void setTitleFormat(String pattern, Locale locale);
  1. Set a listener for callback when date was clicked.
/**
 * Set listener for date be clicked.
 *
 * @param onDateClickedListener listener
 */
public void setOnDateClickedListener(OnDateClickedListener onDateClickedListener);
  1. Set a listener for callback when showing month changed.
/**
 * Set listener for current showing month changed.
 *
 * @param onMonthChangedListener listener
 */
public void setOnMonthChangedListener(final OnMonthChangedListener onMonthChangedListener);
  1. Set can or can't change month by drag.
/**
 * Set drag enable for page.
 */
public void setCanDrag(boolean canDrag);

/**
 * Return drag enable of page.
 */
public boolean canDrag();
  1. Set can or can't fling when finger off screen.
/**
 * Set fling enable for page.
 */
public void setCanFling(boolean canFling);

/**
 * Return fling enable of page.
 */
public boolean canFling();
  1. Set the visibility of the button for the month of switch.
/**
 * Set button visible for last month.
 *
 * @param visibility {@link Visibility}
 */
public void setLastMonthButtonVisibility(@Visibility int visibility);

/**
 * Set button visible for next month.
 *
 * @param visibility {@link Visibility}
 */
public void setNextMonthButtonVisibility(@Visibility int visibility);
  1. Get view of today.
/**
 * Return item view of today. If today not showing, return null。
 */
public View getTodayItemView();
  1. Set the calendar size will wrap content or not. Use this api you can set the calendar size will wrap content or not. if true, the layout's height will auto change with animation when month changed.
/**
 * Set the layout will wrap content or not.
 *
 * @param scaleEnable if true, the layout will wrap content.
 */
public void setScaleEnable(boolean scaleEnable);

Custom UI for date

You can use default UI for date by SampleVagueAdapter. Default UI only show date.

calendarView.setVagueAdapter(new SampleVagueAdapter());

You can custom UI for date by extend VagueAdapter , e.g. custom UI for checkin.


// layout_checkin_calendar_item must hava a TextView that's id is tv_day_of_month
calendarView.setVagueAdapter(new MyVagueAdapter(R.layout.layout_checkin_calendar_item));

private class MyVagueAdapter extends VagueAdapter<Map<String, Map<String, Checkin>>> {

    /**
     * @params dateLayout layout resource id for date, must hava a TextView that's id is tv_day_of_month
     */
    MyVagueAdapter(@LayoutRes int dateLayout) {
        super(dateLayout);
    }

    @Override
    public void onBindVague(View itemView, int year, @Month int month, @DayOfMonth int dayOfMonth) {
        // do something, show custom data  
    }

    @Override
    public void flagToday(View todayView) {            
        // do something, set a flag for today's view
    }

    @Override
    public void flagNotToday(View dayView, Date date) {
       // do something, set a flag for not today's view
    }
}

License

 Copyright 2017 StoneHui
 
 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.