CalendarView

2.1.2

UICalendarView for SwiftUI
AllanJuenemann/CalendarView

What's New

2024-11-13T04:50:01Z

This fixes potential scrolling issues when using selection (single selection) and visibleDateComponents together (#3).

Note that changing selection causes CalendarView to scroll to that date. However, visibleDateComponents will take priority over selection if both were changed.

Thank you @lishuhao for the reproducible code sample.

This also fixes issues with deselecting dates if they were selected programmatically.

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: Sun May 11 2025 10:51:55 GMT-0900 (Hawaii-Aleutian Daylight Time)