Development platform: iOS
Language: Swift
UI framework: UIKit
Compatibility: iOS 11 or greater
TomatoCal (compatible with iOS 11 or greater, tested with an actual device running iOS 13.3.1, simulator running iOS 14.4) is a customizable Swift framework (those Previous and Next buttons in the screenshot above not included) used for iOS devices in making a calendar. Each cell with a number is a button that the user can tap. And the framework will return the year, the month, day of the month, day of the week of the selected date all as numbers (Int). You can change the cell size (Int) between 24 and 60 (inclusive) such that you can create a calendar adjusted for each device size.
- Set a cell (calendar day button) size for a different device size.
- Have options of starting the week with Sunday or Monday.
- Set weekly exceptions.
- Set daily exceptions.
In order to use this framework, download the sample project. You will find the folder titled 'TomatoCal.' Locate the Xcode file inside. And put this Xcode file in your Xcode project. Select your target and make sure you have 'TomatoCal.framework' under General > Framworks, Libraries, and Embeded Content as shown below.
Now that you have the framework in your project, set up TomatoCal in your view controller. First, instantiate TomatoCal to create an object right under the view controller class name. In the viewDidLoad method, call tomatoCal's makeCalendar, which will return a UIView object, which you can add to your view controller's view.
This framework comes with two delegate methods. One is getCalendarNumbers(myYear: Int, myMonth, Int, myDay: Int, myDayOfWeek). This method will return the calendar date of user's selection when they tap one of calendar day buttons. The other delegate method will return the initial calendar year and month. When you set up TomatoCal, you can tell it of the initial year and month with its startYear and startMonth. Or set its hasCurrentDate to true and let the framework set the current calendar year and month according to the device. In the latter case, you can get them through the second delegate method.
You have options of starting each week with Sunday or Monday. The default option is the former. If you want to start the calendar week with Monday, set mondayFirst to true.
Lastly, it's your job to keep track of the current year and month. If necessary, create two Int variables like currentYear and currentMonth in your view controller. If you want to advance the calendar by one month, add 1 to currentMonth and then call TomatoCal's changeDaysOfMonth(myYear:, myMonth:) method.
Imagine a situation where you are a hairdresser and want to let your customers make an appointment with a calendar, using TomatoCal. You don't want to let them select any day of the week. You take a day off every Monday. That's a situation where weekly exceptions come into play. First, you instantiate TomatoCal() like
let tomatoCalendar = TomatoCal()
tomatoCalendar.weeklyExceptions = [2]
, where the weeklyExceptions property is an array of intergers between 1 and 7, inclusive. 1 is for Sunday, 2 for Monday, ..., 7 for Saturday. Well, you don't really work on the Christmas day, do you? How about the New Year's Day? In these cases, you use daily exceptions. Use TomatoCalExceptionModel to make exception cases like
let exception0 = TomatoCalExceptionModel(year: 2021, month: 12, dayOfMonth: 25)
let exception1 = TomatoCalExceptionModel(year: 2022, month: 1, dayOfMonth: 1)
tomatoCalendar.dailyExceptionModels = [exception0, exception1]
You can set separate button colors for weekly and daily exceptions. Use the weeklyExceptionBackColor property for weekly exceptions, dailyExceptionBackColor for daily exceptions. As you see in the screenshot above, all daily buttons for Monday have a different color. So does the 25th of December. The user will not be able to tap any of these exception days. If they can't tap any of those calendar day buttons, they won't be able to make an appointment. Sounds good?