Calendar View Library
A Month and a Week view group to present data.
Features:
- Customizable colors and text sizes
- Overflow mark below the day when the views don't fit
- First day of the week can be set to Sunday, Saturday or Monday
Screenshots
Add to your project using gradle
compile 'com.sickmartian.calendarview:calendarview:1.0.0'
Customizable properties at a glance
<com.sickmartian.calendarview.MonthView
xmlns:calendar_view="http://schemas.android.com/apk/res-auto"
android:layout_below="@+id/control_container"
calendar_view:textSize="12sp"
calendar_view:activeTextColor="@color/colorPrimaryText"
calendar_view:inactiveTextColor="@color/colorSecondaryText"
calendar_view:activeBackgroundColor="@color/colorCalendarDayBackground"
calendar_view:selectedBackgroundColor="@color/selectedDayBackground"
calendar_view:inactiveBackgroundColor="@color/notThisMonthDayBackground"
calendar_view:currentDayDecorationDrawable="@drawable/current_day_drawable"
calendar_view:currentDayDecorationSize="24dp"
calendar_view:currentDayTextColor="@color/colorInvertedText"
calendar_view:showOverflow="false"
calendar_view:overflowColor="@color/colorPrimary"
calendar_view:overflowHeight="2dp"
calendar_view:separatorColor="@color/colorCalendarDivider"
android:id="@+id/monthView"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
API
The API for getting the pressed, current and/or selected day works via the DayMetadata class. DayMetadata
is just a value holder for the day, month and year. It takes the months of the year starting with 1 (so January is 1, December is 12, like joda-time does)
Some methods also have a Calendar
alternative that is just there for convenience, in this case the Day, Month and Year values will be read directly, no timezone awarenes is built in.
Adding views to the view group can be done via the day of the month for the MonthView
( addViewToDayInCurrentMonth
) or using DayMetadata
for the WeekView
( addViewToDay
).
Alternatively you can use the cell id ( addViewToCell
), this is not perfect as the state won't be preserved on rotation in some cases but at least allows you to add data to neightbor months when using MonthView
.
First day of the week is set like this
mCalendarView.setFirstDayOfTheWeek(CalendarView.SUNDAY_SHIFT);
In Action
This library powers the Trackendar app that you can find on Google Play download it to see it in a production scenario
Alternatively just clone the repo and submodule using:
git clone --recursive https://github.com/sickmartian/CalendarView.git
The sample app that's on the screenshots can be used to test the library.
###License
Copyright 2017 sickmartian 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.