CalendarView

2.1.0

UICalendarView for SwiftUI
AllanJuenemann/CalendarView

What's New

2024-05-18T00:21:26Z

The modifier decorating(_:customView:) can now have a DateComponents parameter. This makes it possible to take the date being decorated into account when returning a custom view. For example:

CalendarView()
    .decorating(specialDates) { dateComponents in
        Text(specialTitle(for: dateComponents))
    }

CalendarView

CalendarView makes UIKit's UICalendarView with all its features available to SwiftUI.

Please note that UICalendarView uses DateComponents rather than Date. CalendarView uses the same convention for consistency but might add support for Date in the future.

Usage

Displaying the calendar

import SwiftUI
import CalendarView

var body: some View {
  CalendarView()
}

Configuring the calendar

CalendarView uses the calendar, time zone and locale from the environment.

CalendarView()
  .environment(\.locale, .init(identifier: "ja"))

The font design can be configured by using the fontDesign modifier.

CalendarView()
  .fontDesign(.serif)

You can also set the available date range.

CalendarView(availableDateRange: specialEvent)

Updating visible components

You can set and update the current components (year, month) that should be visible in the calendar.

VStack {
  CalendarView(visibleDateComponents: $visibleComponents)
  
  Button("Today") {
    withAnimation {
      visibleComponents = calendar.dateComponents([.year, .month], from: .now)
    }
  }
}

Using decorations

Use the decorating modifier to decorate specific days.

CalendarView()
  .decorating([DateComponents(day: 16)])

Decorations can also be customized.

CalendarView()
  .decorating(specialDates, systemImage: "star.fill", color: .yellow)
  .decorating(otherDates, color: .green, size: .large)

Handling selections

CalendarView supports selections of single and multiple dates.

CalendarView(selection: $selectedDates)

You can also configure which dates are selectable and deselectable.

CalendarView(selection: $selectedDates)
  .selectable { dateComponents in
    dateComponents.day > 15
  }
  .deselectable { dateComponents in
    dateComponents.year == currentYear && dateComponents.month == currentMonth
  }

Description

  • Swift Tools 5.7.0
View More Packages from this Author

Dependencies

  • None
Last updated: Sat Nov 23 2024 22:01:09 GMT-1000 (Hawaii-Aleutian Standard Time)