Skip to content
Small simple android calendar implementation
Java
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
gradle/wrapper initial commit Nov 3, 2015
lib Coverage (#7) Jan 2, 2018
simple_sample
styled_sample Coverage (#7) Jan 2, 2018
.gitignore added more complex sample Nov 9, 2015
.travis.yml
LICENSE licence file added (MIT) Nov 9, 2015
README.md add coverage badge Jan 2, 2018
build.gradle
gradle.properties
gradlew initial commit Nov 3, 2015
gradlew.bat initial commit Nov 3, 2015
settings.gradle

README.md

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

  • a simple view, not a fragment
  • item layout xml provided by developer, not included
  • supports i18n by different starting days of week
  • support selection (style via xml selected state)
  • shows last/first days of surrounding months where needed (row count configurable, style via xml disabled state)
  • marks today
  • supports adding custom view holder and adapters but not needed (see styled_sample)
  • no multiselect
  • no right-to-left (in progress)

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

You can’t perform that action at this time.