Events Calendar


Single Selection Mode	Range Selection Mode	Multiple Selection Mode

What is Events Calendar?

Events Calendar is a user-friendly library that helps you achieve a cool Calendar UI with events mapping. You can customise every pixel of the calendar as per your wish and still achieve in implementing all the functionalities of the native android calendar in addition with adding dots to the calendar which represents the presence of an event on the respective dates. Events Calendar also has multi-lingual support. You are just a few steps away from implementing your own badass looking Calendar for your very own project!

Implementation

[1] In your app module gradle file

dependencies {
    implementation 'com.github.tizisdeepan:eventscalendar:1.5.2'
}

[2] In your project level gradle file

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

[3] Use EventsCalendar in your layout.xml

<com.events.calendar.views.EventsCalendar
    android:id="@+id/eventsCalendar"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="#000000"
    android:overScrollMode="never"
    app:eventDotColor="#ff0000"
    app:isBoldTextOnSelectionEnabled="true"
    app:monthTitleColor="#ffffff"
    app:primaryTextColor="#c4c4c4"
    app:secondaryTextColor="#666666"
    app:selectedTextColor="#000000"
    app:selectionColor="#ffe600"
    app:weekHeaderColor="#c6c6c6"
    app:rangeSelectionColor="#ffe600"
    app:rangeSelectionStartColor="#c1ae01"
    app:rangeSelectionEndColor="#c1ae01" />

[4] Implement EventCalendar.Callback on your Activity/ Fragment

class MainActivity : AppCompatActivity(), EventsCalendar.Callback {
    ...
    override fun onDayLongPressed(selectedDate: Calendar?) {
        Log.e("LONG", "CLICKED")
    }
    
    override fun onMonthChanged(monthStartDate: Calendar?) {
        Log.e("MON", "CHANGED")
    }

    override fun onDaySelected(selectedDate: Calendar?) {
        Log.e("SHORT", "CLICKED")
    }
}

[5] Create instances and set default values for the EventsCalendar in your Activity/ Fragment

//set today's date [today: Calendar]
eventsCalendar.setToday(today)
//set starting month [start: Calendar] and ending month [end: Calendar]
eventsCalendar.setMonthRange(start, end)
//set start day of the week as you wish [startday: Int, doReset: Boolean]
eventsCalendar.setWeekStartDay(Calendar.SUNDAY, false)
//set current date and scrolls the calendar to the corresponding month of the selected date [today: Calendar]
eventsCalendar.setCurrentSelectedDate(today)
//set font for dates
eventsCalendar.setDatesTypeface(typeface)
//set font for title of the calendar
eventsCalendar.setMonthTitleTypeface(typeface)
//set font for week names
eventsCalendar.setWeekHeaderTypeface(typeface)
//set the callback for EventsCalendar
eventsCalendar.setCallback(this)
//set events on the EventsCalendar [c: Calendar]
eventsCalendar.addEvent(c)
//disable a specific day on the EventsCalendar [c: Calendar]
eventsCalendar.disableDate(dc)
//disable days in a week on the whole EventsCalendar [varargs days: Int]
eventsCalendar.disableDaysInWeek(Calendar.SATURDAY, Calendar.SUNDAY)

[6] You can change selection mode of the calendar as you wish

eventsCalendar.setSelectionMode(eventsCalendar.SINGLE_SELECTION)

Available Selection modes are,

SINGLE_SELECTION -> can select single day at a time
RANGE_SELECTION -> can select range of days at a time
MULTIPLE_SELECTION -> can select multiple days at a time (not necessary that the selected days be consequtive)

Documentation

XML	Kotlin/Java	Description
`app:primaryTextColor`	`setPrimaryTextColor(color: Int)`	Primary Text color of the calendar (selectable dates)
`app:secondaryTextColor`	`setSecondaryTextColor(color: Int)`	Secondary Text color of the calendar (disabled dates)
`app:selectedTextColor`	`setSelectedTextColor(color: Int)`	Text color of the Selected date
`app:selectionColor`	`setSelectionColor(color: Int)`	Color for the Selection Circle
`app:rangeSelectionColor`	`setRangeSelectionColor(color: Int)`	Color for the Selection Background
`app:rangeSelectionStartColor`	`setRangeSelectionStartColor(color: Int)`	Color for the Range Start Selection Background
`app:rangeSelectionEndColor`	`setRangeSelectionEndColor(color: Int)`	Color for the Range End Selection Background
`app:weekHeaderColor`	`setWeekHeaderColor(color: Int)`	Text color for the Week Header labels
`app:monthTitleColor`	`setMonthTitleColor(color: Int)`	Text color for the Month Title in the calendar view
`app:eventDotColor`	`setEventDotColor(color: Int)`	Color for the Event Dots marked in the calendar view
`app:isBoldTextOnSelectionEnabled`	`setIsBoldTextOnSelectionEnabled(isEnabled: Boolean)`	Sets whether the dates should be highlighted or not

Voila! You have implemented an awesome Events Calendar for your Android Project now!

Developed By

Deepan Elango - [email protected]

xiangyutian / eventscalendar Goto Github PK

eventscalendar's Introduction

Events Calendar

What is Events Calendar?

Implementation

[1] In your app module gradle file

[2] In your project level gradle file

[3] Use EventsCalendar in your layout.xml

[4] Implement EventCalendar.Callback on your Activity/ Fragment

[5] Create instances and set default values for the EventsCalendar in your Activity/ Fragment

[6] You can change selection mode of the calendar as you wish

Documentation

Developed By

eventscalendar's People

Contributors

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent