https://github.com/blackboxvision/material-calendar-view

📅 Material Design Calendar compatible with API 11+
https://github.com/blackboxvision/material-calendar-view

android calendar calendar-view custom-view java library material-calendar material-design

Last synced: 1 day ago
JSON representation

📅 Material Design Calendar compatible with API 11+

• Host: GitHub
• URL: https://github.com/blackboxvision/material-calendar-view
• Owner: BlackBoxVision
• License: mit
• Created: 2015-10-30T19:47:00.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2018-10-08T16:17:54.000Z (about 6 years ago)
• Last Synced: 2024-12-22T19:29:08.327Z (2 days ago)
• Topics: android, calendar, calendar-view, custom-view, java, library, material-calendar, material-design
• Language: Java
• Homepage:
• Size: 7.26 MB
• Stars: 370
• Watchers: 16
• Forks: 70
• Open Issues: 24
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        


> Prettier and simpler Material Design CalendarView

[![License: MIT](https://img.shields.io/badge/License-MIT-brightgreen.svg)](https://opensource.org/licenses/MIT) [![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-Material%20Calendar%20View-brightgreen.svg?style=flat)](http://android-arsenal.com/details/1/2715) [![](https://jitpack.io/v/BlackBoxVision/material-calendar-view.svg)](https://jitpack.io/#BlackBoxVision/material-calendar-view) ![Build Status](https://travis-ci.org/BlackBoxVision/material-calendar-view.svg?branch=master) [![OpenCollective](https://opencollective.com/material-calendar-view/backers/badge.svg)](#backers) 

[![OpenCollective](https://opencollective.com/material-calendar-view/sponsors/badge.svg)](#sponsors)

 

**MaterialCalendarView** is a **prettier** and **simpler**, **material design calendar** that allows full customization and it's backwards compatible with API 11+.

## Screenshots



	

	





## Installation

**Gradle**

- Add it in your root build.gradle at the end of repositories:

```java

repositories {

	maven { 

	    url "https://jitpack.io"

	}

}

```

- Add the dependency:

```java

dependencies {

    compile 'com.github.BlackBoxVision:material-calendar-view:v1.5.8'

}

```

**Maven**

- Add the JitPack repository to your maven file. 

```xml

     jitpack.io

     https://jitpack.io

```

- Add the dependency in the form

```xml

    com.github.BlackBoxVision

    material-calendar-view

    v1.5.8

```

**SBT**

- Add it in your build.sbt at the end of resolvers:

```java

resolvers += "jitpack" at "https://jitpack.io"

```

- Add the dependency in the form:

```java

libraryDependencies += "com.github.BlackBoxVision" % "material-calendar-view" % "v1.5.8"

```

## Usage example

In your layout.xml file:

```xml

```

This example shows all the possible customization around Material Calendar View:

```xml

```

Then, in your Activity.java or Fragment.java initialize the calendar: 

```java

calendarView = (CalendarView) findViewById(R.id.calendar_view);

calendarView.shouldAnimateOnEnter(true)

	.setFirstDayOfWeek(Calendar.MONDAY)	

	.setOnDateClickListener(this::onDateClick)

	.setOnMonthChangeListener(this::onMonthChange)

	.setOnDateLongClickListener(this::onDateLongClick)

	.setOnMonthTitleClickListener(this::onMonthTitleClick);

if (calendarView.isMultiSelectDayEnabled()) {

	calendarView.setOnMultipleDaySelectedListener(this::onMultipleDaySelected);

}

calendarView.update(Calendar.getInstance(Locale.getDefault()));

```

## Issues

If you found a bug, or you have an answer, or whatever. Please, open an [issue](https://github.com/BlackBoxVision/material-calendar-view/issues). I will do the best to fix it, or help you.

## Contributing

Of course, if you see something that you want to upgrade from this library, or a bug that needs to be solved, **PRs are welcome!**

## Backers

Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/material-calendar-view#backer)]





























































## Sponsors

Become a sponsor and get your logo on our README on Github with a link to your site. [[Become a sponsor](https://opencollective.com/material-calendar-view#sponsor)]





























































## License

Distributed under the **MIT license**. See [LICENSE](https://github.com/BlackBoxVision/material-calendar-view/blob/master/LICENSE) for more information.