About

YACalendar is a highly customizable iOS calendar that’s easy to integrate into your application. Currently, it supports year and month views with vertical and horizontal scrolling. Our solution optimized for all iPhone screens, so it will display correctly on old devices like the iPhone 5 as well as on the newest iPhone models. YACalendar is constantly evolving and aims to become a one-size-fits-all solution. We’re planning to add event management functionality and the ability to attach notes, links, and documents to events.

Features

Project example

Take a look at an example project here

Requirements

• Swift 5.0
• Xcode 11.2
• iOS 10.0+

Installation

To install YACalendar via CocoaPods, add the following lines to your Podfile:

use_frameworks!

pod 'YACalendar'

Then make sure to add this line to your code: import YACalendar

Using YACalendar

1. Create a calendar view instance and add it to the view hierarchy.

let calendarView = CalendarView(frame: frame)
view.addSubview(calendarView)

NOTE: You can use an interface builder for creating a calendar view. Here’s an example.

2. Create a calendar. If you want to change the first day of the week, change the firstWeekday property.

let calendar = Calendar.current
calendar.firstWeekday = 2 // 1 - Sunday, 2 - Monday

3. Specify the calendar grid type and scroll direction.

calendarView.grid.calendarType = .oneOnOne
calendarView.grid.scrollDirection = .vertical

4. Create the calendar data object, which contains the calendar itself, the start date, and the end date. Set it to the data property of the calendar view. All days will be displayed according to the specified calendar and within the range of the start and end dates.

calendarView.data = CalendarData(calendar: calendar, startDate: startDate, endDate: endDate)

NOTE: After setting the data property, the calendar will be redrawn.

Examples

Month view

Month view with vertical and horizontal scrolling:

let calendarView = CalendarView(frame: frame)
calendarView.grid.calendarType = .onOnOne
calendarView.data = CalendarData()

Year view 3×4 grid

Year view with a 3×4 grid for portrait orientation and a 5×2 grid for landscape orientation:

var calendarView = CalendarView(frame: frame)
calendarView.grid.calendarType = .threeOnFour
calendarView.data = CalendarData()

Year view 2×3 grid

Year view with a 2×3 grid for portrait orientation and a 3×1 grid for landscape orientation:

let calendarView = CalendarView(frame: frame)
calendarView.grid.calendarType = .twoOnThree
calendarView.data = CalendarData()

Customization

These settings can be configured directly on the CalendarView.

Calendar properties

Calendar Methods

Changing the look of the day, month, month header, day symbols, and year header

If you want to change the font, color, or other UI properties of one of these elements, you must override the corresponding element config.

For example, to change the text color for days:

1. Inherit DayConfig and override the method.

class MyDayConfig: DayConfig {
    
    override func textColor(for state: DayState, indicator: DayIndicator) -> UIColor {
        return .black
    }
}

2. Set config to the calendar.

calendarView.config.day = MyDayConfig()

Grid Properties

You can set these settings by calling calendar.grid

Project plans

We have far-reaching plans to improve YACalendar. We want to add:

• Event view (creating, management, recurring events)
• Appointment scheduling view
• Dark mode

Release Notes

Version 1.0

• Release version.

License

YACalendar is released under an MIT License. See LICENSE for details.