yuizr / fscalendar

A superiorly awesome iOS7+ calendar control, compatible with both Objective-C and Swift2

Screenshots

iPhone

iPad

Working with AutoLayout and Orientation

Installation

CocoaPods:

• For iOS8+: 👍

use_frameworks!
pod 'FSCalendar'

• For iOS7+:

pod 'FSCalendar'

• Alternatively to give it a test run, run the command:

pod try FSCalendar

Carthage:

• For iOS8+

github "WenchaoD/FSCalendar"

Manually:

• Drag all files under FSCalendar folder into your project. 👍

Support IBInspectable / IBDesignable

Only the methods marked "👍" support IBInspectable / IBDesignable feature. Have fun with Interface builder

Setup

Use Interface Builder

1. Drag an UIView object to ViewController Scene
2. Change the Custom Class to FSCalendar
   
3. Link dataSource and delegate to the ViewController
   

4. Finally, you should implement FSCalendarDataSource and FSCalendarDelegate in ViewController.m

Or use code

@property (weak , nonatomic) FSCalendar *calendar;

// In loadView(Recommended) or viewDidLoad
FSCalendar *calendar = [[FSCalendar alloc] initWithFrame:CGRectMake(0, 0, 320, 300)];
calendar.dataSource = self;
calendar.delegate = self;
[self.view addSubview:calendar];
self.calendar = calendar;

Or swift

• To use FSCalendar in swift, you need to Create Bridge Header first.

private weak var calendar: FSCalendar!

// In loadView or viewDidLoad
let calendar = FSCalendar(frame: CGRect(x: 0, y: 0, width: 320, height: 300))
calendar.dataSource = self
calendar.delegate = self
view.addSubview(calendar)
self.calendar = calendar

Hide placeholder dates

1. Set calendar.showsPlaceholders = NO;
2. Implement -calendar:boundingRectWillChange:animated:

// For autoLayout
- (void)calendar:(FSCalendar *)calendar boundingRectWillChange:(CGRect)bounds animated:(BOOL)animated
{
    _calendarHeightConstraint.constant = CGRectGetHeight(bounds);
    [self.view layoutIfNeeded];
}

// For manual layout
- (void)calendar:(FSCalendar *)calendar boundingRectWillChange:(CGRect)bounds animated:(BOOL)animated
{
    calendar.frame = (CGRect){calendar.frame.origin,bounds.size};
}

Roll with Interface Builder

More Usage

• To view more usage, download the zip file and read the example.
• Or you could refer to this document
• To view the full documentation, see CocoaPods Documentation

If you like this repo

• Star this repo.
• Send your calendar screenshot or itunes link address here.

Support me via

• ☕️ This coffee is on me!
• Lunch is on me!
• Have a nice dinner!
• Greate work! Keep the change!

License

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

Contributions

• Issues and pull requests are absolutely welcome.
• For code contributions, please follow Coding Guidelines for Cocoa

Contact

• Email: [email protected]