cal

CalendarHeatmap

A calendar based heatmap which presenting a time series of data points in colors.

Showing:

Popularity

Downloads/wk

0

GitHub Stars

130

Maintenance

Last Commit

1yr ago

Contributors

2

Package

Dependencies

0

License

MIT

Categories

Readme

Calendar Heatmap

CalendarHeatmap Title

CI Status Version License Platform

example

Introduction

CalendarHeatmap is a calendar based heatmap which presenting a time series of data points in colors, inspired by Github contribution chart, and written in Swift.

Installation

CalendarHeatmap is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'CalendarHeatmap'

CalendarHeatmap is also availabele through Carthage, by adding it to your Cartfile:

github "Zacharysp/CalendarHeatmap"

And finally CalendarHeatmap can also be installed using the Swift Package Manager:

Usage

// minimum usage.
let startDate = Date()
let calendarHeatmap = CalendarHeatmap(startDate: startDate)
calendarHeatmap.delegate = self
view.addSubview(calendarHeatmap)
// provide a range of date.
let formatter = DateFormatter()
formatter.dateFormat = "yyyy-MM-dd"
let startDate = formatter.date(from: "2019-10-18")
let endDate = formatter.date(from: "2020-02-14")
// default endDate is now.
let calendarHeatmap = CalendarHeatmap(startDate: startDate, endDate: endDate)
// you could custom the heatmap by using CalendarHeatmapConfig.
let config = CalendarHeatmapConfig()
let calendarHeatmap = CalendarHeatmap(config: config, startDate: Date())
// reload the heatmap
let calendarHeatmap = CalendarHeatmap(startDate: ...)
calendarHeatmap.reload()
// reload with new range of date.
calendarHeatmap.reload(newStartDate: ..., newEndDate: ...)

CalendarHeatmapConfig details.

Config KeyTypeDefault
backgroundColorUIColorUIColor.white
contentRightInsetCGFloat60
itemColorUIColorUIColor.clear
itemSideCGFloat20
interitemSpacingCGFloat4
lineSpacingCGFloat4
weekDayColorUIColorUIColor.black
weekDayStrings[String]DateFormatter().shortWeekdaySymbols.map{ \$0.capitalized }
weekDayFontUIFontUIFont.systemFont(ofSize: 12, weight: .medium)
weekDayWidthCGFloat30
weekDayStandardEnumUSandCanada
monthColorUIColorUIColor.black
monthStrings[String]DateFormatter().monthSymbols
monthFontUIFontUIFont.systemFont(ofSize: 12, weight: .medium)
monthHeightCGFloat20

Starts Monday or Sunday.

var config = CalendarHeatmapConfig()
config.weekDayStandard = .USandCanada // starts Sunday. (default)
config.weekDayStandard = .International // starts Monday

Scroll the calendar programmatically

calendarHeatMap.scrollTo(date: Date(...), at: .right, animated: false)

Make your ViewController adopts CalendarHeatmapDelegate

// color for date
func colorFor(dateComponents: DateComponents) -> UIColor {
    guard let year = dateComponents.year,
        let month = dateComponents.month,
        let day = dateComponents.day else { return .clear}
    // manage your color based on date here
    let yourColor = {...}
    return yourColor
}

// (optional) selection at date
func didSelectedAt(dateComponents: DateComponents) {
    guard let year = dateComponents.year,
    let month = dateComponents.month,
    let day = dateComponents.day else { return }
    // do something here
}

// (optional) notify finish loading the calendar
func finishLoadCalendar() {
    // do something here
}

Demo

Take a look at Example, to run the example project, clone the repo, and run pod install from the Example directory first.

Author

Zacharysp, dongjiezach@gmail.com

License

CalendarHeatmap is available under the MIT license. See the LICENSE file for more info.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial