Home

Awesome

Build Status Maven Central codecov

Android Arsenal

clean-simple-calendar

Small simple Android calendar implementation

Time-Square is the ultimate calendar but hard to customize. The alternative Caldroid is based on really unclean code, hard to change, hard to test. Also, custom selection logic is used instead of using selection and disabled states of the views.

This one is

It is just the month widget, no navigation or similar.

testCompile 'de.jodamob.android:clean-simple-calendar:1.0'
 

Quick start:

Add the CalendarWidget to your layout. Call

calendarWidget.set(
	new CalendarBuilder(R.layout.calendar_item_layout, R.layout.calendar_header_layout));

or set more implicit the shown month:

calendarWidget.set(
CalendarDataFactory.getInstance(Locale.getDefault()).create(date, ROWS),
	new CalendarBuilder(R.layout.calendar_item_layout, R.layout.calendar_header_layout));

where date is a date for the month to show and ROWS an int naming the number of rows to be shown (6 is default, 4 should be minimum)

done.

The layouts must have the following items:

the header layout (day names) must contain one textView with id R.id.day (see the ids.xml) the content (day numbers) must contain: a TextView with id R.id.date_text and any kind of View with id R.id.custom_cell that will be used to set selected state (and disabled state for start/end of non-current month date)

example:


<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
    xmlns:tools="http://schemas.android.com/tools"
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@id/custom_cell"
    android:selectable="true"
    android:background="@drawable/custom_calendar_bg_selector"
	android:layout_width="match_parent"
    android:layout_height="match_parent">

    <TextView
        android:id="@id/date_text"
        android:duplicateParentState="true"
		android:layout_width="wrap_parent"
	    android:layout_height="wrap_parent"/>
</RelativeLayout>

Screenshot from simple_sample (US Locale) alt tag

Screenshot from simple_sample (GERMAN Locale) alt tag

Screenshot from styled_sample with custom fields and selection alt tag

Screenshot from simple_sample (Hebrew language) alt tag

Licensed under MIT license (c) 2015 Danny Preussler