A Material design back port of Android's CalendarView. The goal is to have a Material look and feel, rather than 100% parity with the platform's implementation.
The view now responds better to layout parameters.
The functionality is similar to how adjustViewBounds works with ImageView,
where the view will try and take up as much space as necessary,
but we base it on tile size instead of an aspect ratio.
The exception being that if a tileSize is set,
that will override everything and set the view to that size.
- Add
compile 'com.prolificinteractive:material-calendarview:0.8.1'to your dependencies. - Add
MaterialCalendarViewinto your layouts or view hierarchy. - Set a
OnDateChangedListeneror callMaterialCalendarView.getSelectedDate()when you need it.
Example:
<com.prolificinteractive.materialcalendarview.MaterialCalendarView
android:id="@+id/calendarView"
android:layout_width="match_parent"
android:layout_height="wrap_content"
xmlns:app="http://schemas.android.com/apk/res-auto"
app:mcv_showOtherDates="boolean"
app:mcv_arrowColor="color"
app:mcv_selectionColor="color"
app:mcv_headerTextAppearance="style"
app:mcv_dateTextAppearance="style"
app:mcv_weekDayTextAppearance="style"
app:mcv_weekDayLabels="array"
app:mcv_monthLabels="array"
app:mcv_tileSize="dimension"
app:mcv_firstDayOfWeek="enum"
app:mcv_leftArrowMask="drawable"
app:mcv_rightArrowMask="drawable"
/>One of the aims of this library is to be customizable.
Options available in Java and as XML attributes:
| Attribute | Type | Description |
|---|---|---|
| showOtherDates | boolean | By default, only days of one month are shown. If this is set true,then days from the previous and next months are used to fill the empty space.This also controls showing dates outside of the min-max range. |
| arrowColor | color | Set the color of the arrows used to page the calendar. Black by default. |
| selectionColor | color | Set the color of the date selector. By default this is the color set by?android:attr/colorAccent on 5.0+ or ?attr/colorAccent from the AppCompat library. |
| headerTextAppearance | style | Override the text appearance of the month-year indicator at the top. |
| weekDayTextAppearance | style | Override the text appearance of the week day indicators. |
| dateTextAppearance | style | Override the text appearance of the dates. |
| weekDayLabels | array | Supply custom labels for the days of the week. This sets an ArrayWeekDayFormatter on the CalendarView.The default uses Java's Calendar class to get a SHORT display name. |
| monthLabels | array | Supply custom labels for the months of the year. This sets a MonthArrayTitleFormatter on the CalendarView.The default implementation formats using SimpleDateFormat with a "MMMM yyyy" format. |
| tileSize | dimension | Set a custom size for each tile. Each day of the calendar is 1 tile, and the top bar is 1 tile high.The entire widget is 7 tiles by 8 tiles. The default tile size is 44dp. |
| firstDayOfWeek | enum | Set the first day of the month |
| leftArrowMask | drawable | Supply a different drawable mask for the left arrow |
| rightArrowMask | drawable | Supply a different drawable mask for the right arrow |
Options only available in Java:
| Method | Description |
|---|---|
| setMinimumDate() | Set the earliest visible date on the calendar |
| setMaximumDate() | Set the latest visible date on the calendar |
| setSelectedDate() | Set the date to show as selected. Must be within minimum and maximum dates. |
| setTopbarVisible() | Set the top bar (arrows and title) as visible or gone. |
Decorators allow you to change several aspects of each day's appearance.
To do so, you need to make a new instance of DayViewDecorator and add it to the calendar with addDecorator().
Decorating is done via a DayViewFacade that is passed to the decorate() method.
All calls to the DayViewFacade will be applied to every day shouldDecorate() returns true.
DayViewFacade has three methods to allow decoration:
setBackgroundDrawable()set a drawable to draw behind everything else. This also responds to state changes.setSelectionDrawable()allows customizes the selection indicator for specific days.addSpan()sets a span on the entire day label.DotSpanwas added to show a dot centered below the label- For an introduction to spans, see this article.
- If you want to learn more about custom spans, check out this article.
setDaysDisabled()allows you to disable and re-enable days. This will not affect minimum and maximum dates.
If one of your decorators changes after it's been added to the calendar view, make sure you call MaterialCalendarView.invalidateDecorators() to have those changes reflected.
When implementing a DayViewDecorator, make sure that they are as efficent as possible.
Remember that shouldDecorate() needs to be called 42 times for each month view.
An easy way to be more efficent is to convert your data to CalendarDays outside of shouldDecorate().
Would you like to contribute? Fork us and send a pull request! Be sure to checkout our issues first.
Copyright 2015 Prolific Interactive
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.