Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nomanr/WeekCalendar

A simple weekly calendar.
https://github.com/nomanr/WeekCalendar

android android-application androidapp calendar week

Last synced: about 1 month ago
JSON representation

A simple weekly calendar.

Awesome Lists containing this project

README 

        

I AM NOT WORKING ON THIS LIBRARY ANYMORE. I AM NOT VERY PROUD OF THEY WAY I WROTE THIS WIDGET :grin:. I WOULD RECOMMEND TO USE CALENDAR AS A CUSTOM VIEW INSTEAD OF ADDING IT AS GRADLE DEPENDENCY. FORKS + PRS ARE WELCOME. 







WeekCalendar is a library which provides a weekly calendar. 


The sample project includes the usage of the library.

Support for Android 4.0 and up.



Feel free to fork or issue pull requests on github. Issues can be reported on the github issue tracker.






[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-WeekCalendar-green.svg?style=true)](https://android-arsenal.com/details/1/2905)



Demo






Setup



----------



Gradle



    dependencies {

       compile 'noman.weekcalendar:weekcalendar:1.0.6'

    }



 
Maven



    

      noman.weekcalendar

      weekcalendar

      1.0.6

    



Sample Usage



----------



     

Theme the calendar


There are a few xml attributes to customise the calendar. If you feel that any customization option is missing, let me know.



----------



 - `numOfPages` 

 - `daysTextSize`

 - `daysTextColor`

 - `daysBackgroundColor`

 - `weekTextSize`

 - `weekTextColor`

 - `weekBackgroundColor`

 - `selectedBgColor`

 - `todaysDateBgColor`

 - `todaysDateTextColor`

 - `dayNameLength`

 - `hideNames`



----------



Example



     



Explained



 - `numOfPages`  by default, calendar has 100 pages. You can scroll 49 to left and 49 to right. Using this attribute you can set number of pages. You can send it to 1000, it depends on requirements. 

 - `daysTextSize` day means day of the month. By default text size is `17sp`.

 - `daysTextColor` by default the day text color is set to be white.

 - `daysBackgroundColor` if you have `colorPrimary` attribute in `color.xml`, then the backgroud color will be that one. Otherwise the purple color shown in the demo.

 - `weekTextSize` week means day of the week,i.e (S,M,T ..). By default text size is `17sp`.

 - `weekTextColor` by default the week day text color is set to be white.

 - `weekBackgroundColor`  same as `daysBackgroundColor`

 - `selectedBgColor` By default, its color is set to be `colorAccent`, if you've that attribute in attribute in `color.xml`, then the backgroud color will be that one. Otherwise the pink color shown in the demo.

 - `todaysDateBgColor` todays date background color, same as `selectedBgColor`.

 - `todaysDateTextColor` todays date text color,  by default the text color is set to be white.

 - `dayNameLength` week day name length, `singleLetter` means (S,M,T..) and `threeLetters` means (Sun, Mun, Tue..)

 - `hideNames` , set this attribute to hide name of week days.



----------

Impelement Listener 


`OnDateClickListener` returns `DateTime` object. `DateTime` is class available in Joda Time. I will recommend using this library if you are playing with date and time.



    weekCalendar.setOnDateClickListener(new OnDateClickListener() {

            @Override

            public void onDateClick(DateTime dateTime) {

                Toast.makeText(MainActivity.this, 

                "You Selected " + dateTime.toString(), Toast.LENGTH_SHORT).show();

            }



        });

  See the sample project for usage of methods like 

  - `reset()` 

  - `moveToNext()` 

  - `moveToPrevious()`

  - `setSelectedDate(DateTime)`

  - `setStartDate(DateTime)`



Libraries Used



----------

 - Joda Time

 - Otto



License



----------



    Copyright (c) 2015 Noman Rafique



    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.