Android Week View

An android library to show day view, week view, 3 day view etc. in your app.

License	License The Apache Software License, Version 2.0
GroupId	GroupId com.github.alamkanak
ArtifactId	ArtifactId android-week-view
Last Version	Last Version 1.2.6
Release Date	Release Date Jan 4, 2016
Type	Type aar
Description	Description Android Week View An android library to show day view, week view, 3 day view etc. in your app.
Project URL	Project URL https://github.com/alamkanak/Android-Week-View
Source Code Management	Source Code Management https://github.com/alamkanak/Android-Week-View

Download android-week-view

Filename	Size
android-week-view-1.2.6.pom
android-week-view-1.2.6.aar	26 KB
android-week-view-1.2.6-sources.jar	11 KB
android-week-view-1.2.6-javadoc.jar	48 KB
Browse

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.alamkanak/android-week-view/ -->
<dependency>
    <groupId>com.github.alamkanak</groupId>
    <artifactId>android-week-view</artifactId>
    <version>1.2.6</version>
    <type>aar</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.alamkanak/android-week-view/
implementation 'com.github.alamkanak:android-week-view:1.2.6'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.alamkanak/android-week-view/
implementation ("com.github.alamkanak:android-week-view:1.2.6")

Apache Buildr

'com.github.alamkanak:android-week-view:aar:1.2.6'

Apache Ivy

<dependency org="com.github.alamkanak" name="android-week-view" rev="1.2.6">
  <artifact name="android-week-view" type="aar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.alamkanak', module='android-week-view', version='1.2.6')
)

Scala SBT

libraryDependencies += "com.github.alamkanak" % "android-week-view" % "1.2.6"

Leiningen

[com.github.alamkanak/android-week-view "1.2.6"]

Dependencies

compile (1)

Group / Artifact	Type	Version
com.android.support » appcompat-v7	jar	23.1.1

Project Modules

There are no modules declared in this project.

Android Week View

Android Week View is an android library to display calendars (week view or day view) within the app. It supports custom styling.

Features

Week view calendar
Day view calendar
Custom styling
Horizontal and vertical scrolling
Infinite horizontal scrolling
Live preview of custom styling in xml preview window

Who uses it

Series Addict
Using the library? Just tweet me or send me an email.

Usage

Import the library into your project.

Grab via maven

<dependency>
  <groupId>com.github.alamkanak</groupId>
  <artifactId>android-week-view</artifactId>
  <version>1.2.6</version>
  <type>aar</type>
</dependency>

Grab via gradle

compile 'com.github.alamkanak:android-week-view:1.2.6'

Add WeekView in your xml layout.

<com.alamkanak.weekview.WeekView
        android:id="@+id/weekView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:eventTextColor="@android:color/white"
        app:textSize="12sp"
        app:hourHeight="60dp"
        app:headerColumnPadding="8dp"
        app:headerColumnTextColor="#8f000000"
        app:headerRowPadding="12dp"
        app:columnGap="8dp"
        app:noOfVisibleDays="3"
        app:headerRowBackgroundColor="#ffefefef"
        app:dayBackgroundColor="#05000000"
        app:todayBackgroundColor="#1848adff"
        app:headerColumnBackground="#ffffffff"/>

Write the following code in your java file.

// Get a reference for the week view in the layout.
mWeekView = (WeekView) findViewById(R.id.weekView);

// Set an action when any event is clicked.
mWeekView.setOnEventClickListener(mEventClickListener);

// The week view has infinite scrolling horizontally. We have to provide the events of a
// month every time the month changes on the week view.
mWeekView.setMonthChangeListener(mMonthChangeListener);

// Set long press listener for events.
mWeekView.setEventLongPressListener(mEventLongPressListener);

Implement WeekView.MonthChangeListener, WeekView.EventClickListener, WeekView.EventLongPressListener according to your need.

Provide the events for the WeekView in WeekView.MonthChangeListener.onMonthChange() callback. Please remember that the calendar pre-loads events of three consecutive months to enable lag-free scrolling.

MonthLoader.MonthChangeListener mMonthChangeListener = new MonthLoader.MonthChangeListener() {
    @Override
    public List<WeekViewEvent> onMonthChange(int newYear, int newMonth) {
        // Populate the week view with some events.
        List<WeekViewEvent> events = getEvents(newYear, newMonth);
        return events;
    }
};

Customization

You can customize the look of the WeekView in xml. Use the following attributes in xml. All these attributes also have getters and setters to enable you to change the style dynamically.

allDayEventHeight
columnGap
dayBackgroundColor
dayNameLength
eventMarginVertical
eventPadding
eventTextColor
eventTextSize
firstDayOfWeek
headerColumnBackground
headerColumnPadding
headerColumnTextColor
headerRowBackgroundColor
headerRowPadding
hourHeight
hourSeparatorColor
hourSeparatorHeight
noOfVisibleDays
overlappingEventGap
textSize
todayBackgroundColor
todayHeaderTextColor
showDistinctPastFutureColor
futureBackgroundColor
pastBackgroundColor
showDistinctWeekendColor
futureWeekendBackgroundColor
pastWeekendBackgroundColor
showNowLine
nowLineColor
nowLineThickness
scrollDuration

Interfaces

Use the following interfaces according to your need.

mWeekView.setWeekViewLoader() to provide events to the calendar
mWeekView.setMonthChangeListener() to provide events to the calendar by months
mWeekView.setOnEventClickListener() to get a callback when an event is clicked
mWeekView.setEventLongPressListener() to get a callback when an event is long pressed
mWeekView.setEmptyViewClickListener() to get a callback when any empty space is clicked
mWeekView.setEmptyViewLongPressListener() to get a callback when any empty space is long pressed
mWeekView.setDateTimeInterpreter() to set your own labels for the calendar header row and header column
mWeekView.setScrollListener() to get an event every time the first visible day has changed

Sample

There is also a sample app to get you started.

To do

Add event touch feedback selector
Show events that expand multiple days properly

Changelog

Version 1.2.6

Add empty view click listener
Fix padding bug
Fix bug when setting colors of different components
Add ability to turn off fling gesture
Add example of how to load events asynchronously in the sample app

Version 1.2.5

Add support for using subclasses of WeekViewEvent
Fix scroll animation
Add support for semi-transparent header colors

Version 1.2.4

NOTE: If you are using WeekView.MonthChangeListener, make sure to change it into MonthLoader.MonthChangeListener
Add support to have loaders other than MonthViewLoader
Add pinch to zoom support
Add support for location
Add ability to have different colors for past, future, weekend days
Add support for "now" line

Version 1.2.3

Get callbacks when scrolling horizontally
goToHour and goToDate methods has been fixed
Use getFirstVisibleHour method to get the first visible hour in the week view

Version 1.2.1

Better scrolling added
Get callbacks when empty view is tapped/long pressed
Control the speed of scrolling
Support for multiple language added
Ability to set your own interpreter for header row and column added

Version 1.1.7

You can now dynamically scroll to an hour of your preference.

Version 1.1.6

Added support for events that expands to multiple days

Version 1.1.5

A bug related to overlapping events fixed
You can now programmatically get first and last visible day in the week view

Version 1.1.4

Small bug fixed

Version 1.1.3

Margins support added for overlapping events

Version 1.1.2

Small bugs fixed
Hour separator inconsistency fixed

Version 1.1.1

Overlapping event bug fixed

Version 1.1.0

Added support for overlapping events

License

Copyright 2014 Raquib-ul-Alam

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.

Versions

Version
1.2.6 Jan 4, 2016
1.2.4 Dec 12, 2015
1.2.3 May 9, 2015
1.2.2 May 9, 2015
1.2.1 Jan 6, 2015
1.2.0 Jan 6, 2015
1.1.7 Nov 21, 2014
1.1.6 Nov 15, 2014
1.1.5 Oct 31, 2014
1.1.4 Oct 14, 2014
1.1.3 Oct 14, 2014
1.1.2 Oct 4, 2014
1.1.1 Oct 4, 2014
1.1.0 Oct 4, 2014
1.0.3 Sep 27, 2014
1.0.2 Sep 22, 2014
1.0.1 Sep 21, 2014
1.0.0 Sep 19, 2014

Android Week View

License

GroupId

ArtifactId

Last Version

Release Date

Type

Description

Project URL

Source Code Management

Download android-week-view

How to add to project

Dependencies

compile (1)

Project Modules

Android Week View

Features

Who uses it

Usage

Customization

Interfaces

Sample

To do

Changelog

License

Versions