Fully Customizable DateScrollPicker in Swift5

DateScrollPicker

You can use DateScrollPicker as a calendar with scroll date views. This collection has infinite date cells with animated selection. Customize all these cells with your own fonts and colors with DateScrollPickerFormat. Take a look to next params and learn how to use.

• language: Swift 5.0
• platform: ios 
• device: iphone | ipad
• license: MIT

Tag

• instagram-stories
• Date picker
• UITableview
• ios
• swift
• Scroll Date Picker
• UIScrollview
• swift5

DateScrollPicker

• Awesome infinite date picker
• Totally customizable
• Animation selection
• Show custom data for each date
• Easy usage
• Supports iOS, written in Swift 5

Installation

DateScrollPicker is available through CocoaPods. To install it, simply add the following line to your Podfile and run pod install:

pod 'DateScrollPicker'

Then you can import it when you need

import DateScrollPicker

Usage

In the example you will see some datescrollpicker views with different formats that can be used in your project. Once you’ve installed the pod, follow next steps. It’s really simple:

UIView in your xib / storyboard

Add a UIView in the xib where you want to place DateScrollPicker view. Then you have to input the class name in the view, you can change this in the identity inspector of the interface builder. Remember to input DateScrollPicker in both (Class & Module)

Then, connect the IBOutlet in your UIViewController

@IBOutlet weak var dateScrollPicker: DateScrollPicker!

Format

You can format DateScrollPicker with your own parameters. Use it in all fields to get the same style. See default values:

var format = DateScrollPickerFormat()

/// Number of days

format.days = 5

/// Top label date format

format.topDateFormat = "EEE"

/// Top label font

format.topFont = UIFont.systemFont(ofSize: 10, weight: .regular)

/// Top label text color

format.topTextColor = UIColor.black

/// Top label selected text color

format.topTextSelectedColor = UIColor.white

/// Medium label date format

format.mediumDateFormat = "dd"

/// Medium label font

format.mediumFont = UIFont.systemFont(ofSize: 30, weight: .bold)

/// Medium label text color

format.mediumTextColor = UIColor.black

/// Medium label selected text color

format.mediumTextSelectedColor = UIColor.white

/// Bottom label date format

format.bottomDateFormat = "MMM"

/// Bottom label font

format.bottomFont = UIFont.systemFont(ofSize: 10, weight: .regular)

/// Bottom label text color

format.bottomTextColor = UIColor.black

/// Bottom label selected text color

format.bottomTextSelectedColor = UIColor.white

/// Day radius

format.dayRadius: CGFloat = 5

/// Day background color

format.dayBackgroundColor = UIColor.lightGray

/// Day background selected color

format.dayBackgroundSelectedColor = UIColor.darkGray

/// Selection animation

format.animatedSelection = true

/// Separator enabled

format.separatorEnabled = true

/// Separator top label date format

format.separatorTopDateFormat = "MMM"

/// Separator top label font

format.separatorTopFont = UIFont.systemFont(ofSize: 20, weight: .bold)

/// Separator top label text color

format.separatorTopTextColor = UIColor.black

/// Separator bottom label date format

format.separatorBottomDateFormat = "yyyy"

/// Separator bottom label font

format.separatorBottomFont = UIFont.systemFont(ofSize: 20, weight: .regular)

/// Separator bottom label text color

format.separatorBottomTextColor = UIColor.black

/// Separator background color

format.separatorBackgroundColor = UIColor.lightGray.withAlphaComponent(0.2)

/// Fade enabled

format.fadeEnabled = false

/// Animation scale factor

format.animationScaleFactor: CGFloat = 1.1

/// Animation scale factor

format.dayPadding: CGFloat = 5

/// Top margin data label

format.topMarginData: CGFloat = 10

/// Dot view size
format.dotWidth: CGFloat = 10

Is important to finally assign format to DateScrollPicker

dateScrollPicker.format = format

Implement datasource and delegate

The first way to customize this DateScrollPicker is implementing delegate and datasource methods. These methods handle the most common use cases. Both of them are optional.

dateScrollPicker.dataSource = self

dateScrollPicker.delegate = self

Datasource

Is used to provide data for the field view. The data source must adopt the DateScrollPickerDataSource protocol

// Returns custom attributed string for top label
func dateScrollPicker(_ dateScrollPicker: DateScrollPicker, topAttributedStringByDate date: Date) -> NSAttributedString?
// Returns custom attributed string for medium label

func dateScrollPicker(_ dateScrollPicker: DateScrollPicker, mediumAttributedStringByDate date: Date) -> NSAttributedString?

// Returns custom attributed string for bottom label

func dateScrollPicker(_ dateScrollPicker: DateScrollPicker, bottomAttributedStringByDate date: Date) -> NSAttributedString?

// Returns custom attributed string for separator top label

func dateScrollPicker(_ dateScrollPicker: DateScrollPicker, separatorTopAttributedStringByDate date: Date) -> NSAttributedString?

// Returns custom attributed string for separator bottom label

func dateScrollPicker(_ dateScrollPicker: DateScrollPicker, separatorBottomAttributedStringByDate date: Date) -> NSAttributedString?

// Returns custom attributed string for data label

func dateScrollPicker(_ dateScrollPicker: DateScrollPicker, dataAttributedStringByDate date: Date) -> NSAttributedString?

// Returns custom color for dot view

func dateScrollPicker(_ dateScrollPicker: DateScrollPicker, dotColorByDate date: Date) -> UIColor?

Delegate

In order to add more functionality in your app, you must implement DateScrollPickerDelegate . Is the responsible for managing selection behavior and interactions with fields.

// Called when date is selected
func dateScrollPicker(_ dateScrollPicker: DateScrollPicker, didSelectDate date: Date)

Extra

You can also use next methods for scrolling to current date or other.

// Scroll to current date

func selectToday(animated: Bool?)

// Scroll to date

func scrollToDate(date: Date, animated: Bool?)

Download

DateScrollPicker