ECWeekView

See the swiftui branch for updates.

An iOS calendar library for displaying calendar events in a week view.

Features

• See calendar events in a week view
• Asynchronously load calendar events
• Interaction with specific events by clicking
• Interaction with free time spaces by clicking
• Custom styling
• Infinite horizontal scrolling

Installation

Swift Package Manager

.package(url: "https://github.com/EvanCooper9/swift-week-view")

Usage

1. Implement the ECWeekViewDataSource

Implement the weekViewGenerateEvents protocol function. This function should return a list of ECWeekViewEvents specific to the day of date. Events that can be created immediately should be returned to this function. Events that require time to create should be passed to eventCompletion, which will overwrite previously returned events. See here for SwiftDate documentation on creating date objects at specific times. Currently, events rely on a 24-hour clock.

func weekViewGenerateEvents(_ weekView: ECWeekView, date: DateInRegion, eventCompletion: @escaping ([ECWeekViewEvent]?) -> Void) -> [ECWeekViewEvent]? {
  let start: DateInRegion = date.dateBySet(hour: 12, min: 0, secs: 0)!
  let end: DateInRegion = date.dateBySet(hour: 13, min: 0, secs: 0)!
  let event: ECWeekViewEvent = ECWeekViewEvent(title: "Lunch", start: start, end: end)

  DispatchQueue.global(.background).async {
    // do some async work & create events...
    eventCompletion([event, ...])
  }

  return [event]
}

Available arguments for ECWeekViewEvent

• title: the title of the event
• subtitle: a subtitle or description of the event
• start: the start time of the event
• end: the end time of the event

2. Initialize the instance

2A. Programmatically

Create an instance of ECWeekView, specify it's data source, and add it as a subview.

let weekView = ECWeekView(frame: frame, visibleDays: 5)
weekView.dataSource = self
addSubview(weekView)

Available arguments for ECWeekView

• frame: the frame of the calendar view
• visibleDays: amount of days that are visible on one page. Default = 5
• date: (Optional) the day ECWeekView will initially load. Default = today

2B. Storyboard

Add a view to the storyboard and set it's class ECWeekView. Assign the view's data source programmatically.

@IBOutlet weak var weekView: ECWeekView!
weekView.dataSource = self

User Interaction

To handle interaction with ECWeekView, implement the ECWeekViewDelegate protocol and set the delegate property to the implementing class.

// Fires when a calendar event is touched on
func weekViewDidClickOnEvent(_ weekView: ECWeekView, event: ECWeekViewEvent, view: UIView)

// Fires when a space without an event is tapped
func weekViewDidClickOnFreeTime(_ weekView: ECWeekView, date: DateInRegion)

Custom Styling

To use custom styling, implement the ECWeekViewStyler protocol and assign the styler property to the implementing class. ECWeekView by default is its own styler.

// Creates the view for an event
func weekViewStylerECEventView(_ weekView: ECWeekView, eventContainer: CGRect, event: ECWeekViewEvent) -> UIView

// Create the header view for the day in the calendar. This would normally contain information about the date
func weekViewStylerHeaderView(_ weekView: ECWeekView, with date: DateInRegion, in cell: UICollectionViewCell) -> UIView