Go to file

f33chobits 9e1bbcc874 Almost there Almost there		2015-03-12 22:42:53 +08:00
Example	Almost there	2015-03-12 22:42:53 +08:00
Pod	Almost there	2015-03-12 22:42:53 +08:00
.gitignore	Initial commit	2015-02-13 22:10:59 +08:00
FSCalendar.podspec	Update podspec	2015-03-11 23:05:37 +08:00
LICENSE	Initial commit	2015-02-13 22:10:59 +08:00
README-cn.md	Update README-cn.md	2015-03-10 10:53:57 +08:00
README.md	Update README.md	2015-03-10 10:53:31 +08:00

README.md

FSCalendar

##中文文档

Features

1. Smooth Scrolling and directions(vertical/horizotal)

2. Appearance adjustment

3. Subtitle(Provided by FSCalendarDataSource,not only Chinese)

4. iPad compatible

Usage

Using cocoapods:pod 'FSCalendar'
Manually: Drag all .h and .m files in FSCalendar group to your project

#import FSCalendar.h

1. Simple DataSource/Delegate Pattern (IBOutlet supported)

self.calendar.dataSource = self; 
self.calendar.delegate = self;

FSCalendarDataSource

- (NSString *)calendar:(FSCalendar *)calendar subtitleForDate:(NSDate *)date; // set subtitle
- (BOOL)calendar:(FSCalendar *)calendar hasEventForDate:(NSDate *)date; // set event dot

FSCalendarDelegate

- (BOOL)calendar:(FSCalendar *)calendar shouldSelectDate:(NSDate *)date;
- (void)calendar:(FSCalendar *)calendar didSelectDate:(NSDate *)date;
- (void)calendarCurrentMonthDidChange:(FSCalendar *)calendar;

2. Page Direction Supported

_calendar.flow = FSCalendarFlowVertical; //Change to vertical flow, default is FSCalendarFlowHorizontal

3. Flexible Appearance Customization

[[FSCalendar appearance] setWeekdayTextColor:[UIColor redColor]];   // week symbol color
[[FSCalendar appearance] setHeaderTitleColor:[UIColor darkGrayColor]]; // header text color
[[FSCalendar appearance] setEventColor:[UIColor greenColor]]; // event mark color
[[FSCalendar appearance] setSelectionColor:[UIColor blueColor]]; // selection fill color
[[FSCalendar appearance] setHeaderDateFormat:@"yyyy-MM"]; // header date format
[[FSCalendar appearance] setMinDissolvedAlpha:0.5]; // change to 1.0 to make header no alpha
[[FSCalendar appearance] setTodayColor:[UIColor redColor]]; // today fill color
[[FSCalendar appearance] setUnitStyle:FSCalendarUnitStyleCircle]; // shape of today/selection fill color.Circle/Fectangle

4. Header (IBOutlet supported)

FSCalendarHeader *header = [[FSCalendarHeader alloc] initWithFrame:CGRectMake(0,0,_calendar.frame.size.width,44)];
_calendar.header = header;

For more appearance and other usage, look into FSCalendar.h

Requirements

ios 7.0

Known issues

The title size changed as we change frame size of FSCalendar: Automatically adjusting font size based on frame size is default behavior of FSCalendadr, to disable it:

self.calendar.autoAdjustTitle = NO; 
self.calendar.titleFont = otherTitleFont;
self.calendar.subtitleFont = otherSubtitleFont;

titleFont and subtitleFont is also available for UIAppearance selector, but would not take any effect if autoAdjustTitle value is YES

Author

Wenchao Ding, f33chobits@gmail.com

License

FSCalendar is available under the MIT license. See the LICENSE file for more info.

Others

If FSCalendar cannot meet your requirment, welcome to submit issues or pull request
If you are using this library and using custom color modulation, please take a screenshot for your calendar appearance here, this will help others better matching color in their apps, thanks