mijick / calendarview

Calendars made simple (SwiftUI)

Calendar View

Create fully customisable calendar in no time. Keep your code clean

Try demo we prepared

CalendarView is a free and open-source library designed for SwiftUI that makes the process of creating calendars easier and much cleaner.

• Improves code quality. Create a calendar using MCalendarView constructor and pass the selected date / range to it. Simple as never!
• Customize calendar in no time. We know how important customisation is; that's why we give you the opportunity to design your calendar in any way you like.
• Designed for SwiftUI. While developing the library, we have used the power of SwiftUI to give you powerful tool to speed up your implementation process.

Getting Started

✋ Requirements

Platforms	Minimum Swift Version
iOS 14+	5.0
iPadOS 14+	5.0
macOS 11+	5.0
watchOS 7+	5.0

⏳ Installation

Swift Package Manager

Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into the Swift compiler.

Once you have your Swift package set up, adding CalendarView as a dependency is as easy as adding it to the dependencies value of your Package.swift.

dependencies: [
    .package(url: "https://github.com/Mijick/CalendarView.git", branch(“main”))
]

Cocoapods

Cocoapods is a dependency manager for Swift and Objective-C Cocoa projects that helps to scale them elegantly.

Installation steps:

• Install CocoaPods 1.10.0 (or later)
• Generate CocoaPods for your project

    pod init

• Add CocoaPods dependency into your Podfile

    pod 'MijickCalendarView'

• Install dependency and generate .xcworkspace file

    pod install

• Use new XCode project file .xcworkspace

Usage

1. Call initialiser

To declare a CalendarView, call the constructor:

struct ContentView: View {
    @State private var selectedDate: Data? = nil
    @State private var selectedRange: MDateRange? = .init()

    var body: some View {
        MCalendarView(selectedDate: $selectedDate, selectedRange: $selectedRange)
    }
}

2. Customise Calendar

Your MCalendarView can be customised by calling configBuilder inside the initialiser:

struct ContentView: View {
    @State private var selectedDate: Data? = nil
    @State private var selectedRange: MDateRange? = .init()

    var body: some View {
        MCalendarView(selectedDate: nil, selectedRange: $selectedRange) {
            $0
                (...)
                .dayView(NewDayView.init)
                .firstWeekday(.wednesday)
                .monthLabelToDaysDistance(12)
                .weekdaysView(NewWeekdaysView.init)
                (...)
        }
    }
}

3. Customizing WeekdaysView / WeekdayLabel / MonthLabel / DayView

Each calendar element can be easily customised by creating your own view by inheriting the protocol (check Demo Project for more details).

Try our demo

See for yourself how does it work by cloning project we created

License

CalendarView is released under the MIT license. See LICENSE for details.

Our other open source SwiftUI libraries

PopupView - The most powerful popup library that allows you to present any popup
Navigattie - Easier and cleaner way of navigating through your app
GridView - Lay out your data with no effort
Timer - Modern API for Timer

calendarview's Issues

scrollToDate not working correctly when resizing daylabels

I have custom dayviews which have a frame height of 300; that means that by far not the full month is visible at once. When I try to scroll to the current date (which is the month' last currently) the scrollview is centered to the current month. I found the according line in the code, it seems as if this is intended behavior.

But wouldn't it make more sense if the given date is centered instead of the current month? Or at least provide an option to achieve this behavior?